OVERLAY

Toast

Toast presents short feedback through one Dowe-owned surface with the same Card variants, scheme tokens, placement, timing, and Drawer close control on web, Android, and iOS.

PLAYGROUND

Send global feedback

A lowercase toast statement replaces the current message in the generated global presenter. It does not require a Toast node in the page tree.

Set Toast variant in theme.dowe to style global toast statements by default. An explicit variant on a statement still wins.

dowe
theme
  design defaultTheme:"light"
    Toast variant:"soft"
    theme name:"light"

fn saveChanges
  toast value:{ type:"success" title:"Changes saved" message:"Your workspace is up to date." visible:true } duration:6000 position:"top-right" scheme:"success"

Button onClick:saveChanges
  "Save changes"

VARIANTS AND SCHEMES

The Card surface contract

Variant controls the surface treatment and scheme selects its design family. Outlined keeps a readable neutral Card surface with the selected family on its border.

Solid

Family color and matching on-color.

Soft

Soft family pair for quieter feedback.

Outlined

Neutral surface with a family border.

Ghost

Transparent surface with family content.

CLOSE AND TIMING

Dismiss it immediately or let it expire

Every generated Toast includes the same portable SVG close control as Drawer. The surface is non-modal, so the page remains scrollable while the close control stays interactive. Duration closes the presenter automatically.

Manual dismissal

The close control removes the current message on web, Compose, the Android development launcher, and SwiftUI. On iOS, unrelated reactive updates cannot restart a dismissal already in progress.

Automatic dismissal

Duration is normalized in milliseconds. A new toast replaces the current one and starts its own timer.

TARGET BEHAVIOR

One presenter, target-owned output

Dowe keeps the normalized feedback model shared while each generator owns the portable overlay implementation.

WEB

Generated overlay

HTML, CSS, and router state use the Card surface rules, corner placement, shared timer, and SVG close control.

ANDROID

Dowe popup

Compose and the development launcher use the same Card colors, border, metrics, timer, placement, and close SVG.

IOS

Window presenter

SwiftUI measures the feedback surface before mounting only its compact final container in the window. It creates no full-window host or backdrop, and repeated view updates reuse the active presentation or dismissal state.

API

Toast statement props

Use scheme, not color, to select the family. The capital Toast component accepts the same variant, scheme, and position surface props for static or Signal-backed feedback; lowercase toast is the recommended global action statement.

Prop
Type
Default

No data

There are no records to display