Ballmac UI home

Toast Stack

A token-based notification stack with dismissal, optional actions, and pause-on-interaction timing.

  1. Changes saved

    Your team can see the latest version.

  2. Invitation sent

    Alex can join the workspace from their email.

Invitation sent

Installation

$ pnpm dlx shadcn@latest add @ballmac/toast-stack

Usage

import { ToastStack } from "@/components/ballmac/toast-stack"

The full example is in the Code tab above.

Examples

States and variants

  1. Upload paused

    Check your connection and try again.

Upload paused

API reference

PropTypeDefault
toasts

Controlled toast list.

ToastMessage[]—
defaultToasts

Initial toast list when uncontrolled.

ToastMessage[][]
onToastsChange

Called when a toast is dismissed.

(toasts: ToastMessage[]) => void—
durationMs

Auto-dismiss delay; set to 0 to keep toasts until dismissed.

number5000
label

Accessible label for the stack.

string—

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
Tab / Enter / EscapeActivate actions or dismiss a focused toast

Use with AI

A token-based notification stack with dismissal, optional actions, and pause-on-interaction timing. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Toast Stack (@ballmac/toast-stack) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Confirm an asynchronous action
  • Offer undo or retry after a task

Not for

  • Use banner for persistent page-wide messages

Registry JSON: https://ui.ballmac.com/r/toast-stack.json

Credits

Free to use in personal and commercial projects.