Skip to content
Design System
GitHub

Transient feedback on what the user just did: 4 s, 8 s with an action, failures until dismissed. Call toast() anywhere; mount <Toaster /> once.

Toast tones

Install
npx shadcn add @syncrobotic/toast

Also installs: radix-ui, lucide-react, @syncrobotic/cn

Overview

Short feedback on what the user just did, at the edge of the screen: 4 s, 8 s with an action, failures until dismissed.

When to use

  • Saved, copied, mission started, with Undo where possible.

Use something else

  • Anything that needs a person to act: Alarm, never a toast.
  • A state of the page: Alert.

More examples

States and real uses. Each example is also a Storybook story and a visual regression test.

    Toast with undo

      Toast failure with retry

        Toast title only

        Three show, newest in front; the fourth waits behind them. Hover the stack to spread it out.

        Toast queue

        Usage rules

        • The result of what the user just did, or a minor event. Web and dashboard use Toast; the control app uses the island's notices, with the same timings.
        • 4 s; 8 s when it offers an action such as Undo; failures stay until dismissed. Hovering or focusing pauses the timer.
        • At most three on screen, stacked with the newest in front; more wait behind and come forward as those in front go. Hovering, focusing or touching the stack spreads it out. Never use a toast for an alarm.

        Changelog

        • 0.27.02026-11-21Toaster stacks toasts like sonner: newest in front, two more peeking behind it, the rest kept hidden (none is closed to make room) and brought forward as the front ones go; hover, focus or touch spreads the stack. Toasts arrive from the edge and the others move on transform, so a 4th no longer makes the stack jump. Only the first mounted Toaster draws (a second one drew every toast twice and paused only one copy); a swiped toast leaves from where it was let go. Toast wraps its icon and text in a [data-slot=toast-content] div.
        • 0.17.32026-11-19Every toast uses the 16 px radius.
        • 0.17.22026-11-19A comment says where keyboard focus shows instead of the removed outline (no change in behaviour); checked by lint:rules.

        How to upgrade