Skip to content

ToasterPro

Calm toasts from anywhere: a stack that fans out on hover, promise toasts that morph from spinner to check, a timer hairline that pauses while you read, swipe or Escape to dismiss.

oxyn add toaster
Atlas

Hover the stack to fan it out · F8 focuses the newest

  1. Run 247 finished
    12 files changed · 148 tests passed
  2. Approval needed
    Atlas wants to push to main
  3. Indexing repository…
    atlas · 3,412 files
The code is part of Oxyn Pro

The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.

Get Pro

Rendered from Rust at build time · goes live when visible

When to use

  • Short-lived confirmations and background results: a draft saved, a file moved with Undo, an upload that resolves, a sync that failed.
  • They must not cover the work or demand attention.

When not to use

  • Notice cards stacked behind each other: use Notification Stack instead.
  • A persistent message that helps people recover or continue: use Alert instead.
  • Fourteen text-glyph loaders (braille, sand, blocks, scanner…) that settle into a check, a warning or a cross when the agent finishes, waits or fails: use Glyph loader instead.

Installation

Toaster is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.

Terminal
oxyn add toaster

Usage

Dioxus · rust
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Examples

Stack

Three toasts, collapsed.

Atlas

Hover the stack to fan it out · F8 focuses the newest

  1. Run 247 finished
    12 files changed · 148 tests passed
  2. Approval needed
    Atlas wants to push to main
  3. Indexing repository…
    atlas · 3,412 files
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Expanded

Fanned out into a list.

Atlas

Hover the stack to fan it out · F8 focuses the newest

  1. Run 247 finished
    12 files changed · 148 tests passed
  2. Approval needed
    Atlas wants to push to main
  3. Indexing repository…
    atlas · 3,412 files
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Top center

From the top, staying until dismissed.

Atlas

Hover the stack to fan it out · F8 focuses the newest

  1. Run 247 finished
    12 files changed · 148 tests passed
  2. Approval needed
    Atlas wants to push to main
  3. Indexing repository…
    atlas · 3,412 files
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Empty

Press the buttons to send toasts.

Atlas

Hover the stack to fan it out · F8 focuses the newest

    Code Pro
    The code is part of Oxyn Pro

    The preview is free. Pro opens the code of every Pro component, screen and template.

    Get Pro

    API reference

    Toaster

    PropTypeDefaultDescription
    positionString"bottom-right"`top-left` · `top-center` · `top-right` · `bottom-left` · `bottom-center` · `bottom-right`.
    inlineboolDefault::default()Positioned inside the nearest positioned ancestor (20 px offset).
    durationu324000Time on screen ms (0 = until dismissed).
    visibleusize3Toasts visible at once.
    expandboolDefault::default()Always fanned out.
    offsetOption<f32>Default::default()Distance from the edges px (24, inline 20).
    gapf3210.0Gap when fanned out px.
    hotkeyString"F8"Key that focuses the newest toast.
    hairlinebooltrueTimer hairline.
    close_buttonbooltrueClose button on hover and focus.
    labelString"Notifications"Region name.
    seedVec<SeedToast>Default::default()Toasts shown on mount.
    childrenElementDefault::default()The app (calls `use_toasts()`).
    on_actionEventHandler<(u64, String)>—An action was pressed (toast id, label).

    Read from the Rust signature and doc comments.

    Keyboard interactions

    KeyAction
    F8Focus the newest toast and fan the stack out
    TabToast to toast, through action and close
    EscClose the focused toast and move to the next

    Accessibility

    • The stack is a labelled region ("Notifications (F8)"); every toast is focusable.
    • New and updated toasts are announced politely, errors assertively.
    • Timers pause while the pointer or focus is in the stack; swiping is never the only way out.
    From the spec

    One labelled region; every toast is focusable with its title as name. Statuses are announced politely, errors assertively. Timers pause while the pointer or focus is inside, so nothing disappears mid-read. Close and swipe are never the only way out: Escape works too.

    Motion & interaction

    New toasts slide 16 px in from their edge; the stack fans out on hover with a spring. The hairline runs down with the timer and pauses with it. Promise toasts morph: the icon pops into a check or cross that draws in, and the copy rises out of a blur. Swiped toasts follow the finger and fade.

    Timing
    TransitionDurationEasingReduced motion
    Enter320 ms, 16 pxease.out120 ms fade
    Fan out / in360 msease.outinstant
    Exit200 msease.outinstant
    Icon morph300 ms pop + 260 ms drawease.outswap
    Timerduration (4 s)linearsame

    Responsive behaviour

    • 356 px wide; under 600 px it spans the width with 12 px gutters.
    Edge cases (spec)

    Long copy wraps to two lines. More than visible toasts queue with paused timers. Under 600 px the stack spans the width. A toast resolved while hovered starts its timer when the pointer leaves.

    Notes for AI

    • Import Toaster, use_toasts, SeedToast from oxyn_dioxus and include PRIMITIVES_CSS plus the token stylesheet once.
    • A GPUI version exists: ToasterEl in oxyn_gpui.
    • Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.

    Guides

    Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI