Shelf is open source and in early preview
Shelf

For AI agents: the documentation index is at /llms.txt, and any docs page is available as Markdown by appending .md to its URL.

Toast

Brief notifications queued from anywhere in the app: stacked, swipeable, with success, error, and loading states.

When to use

Use when
Brief feedback after an action, such as saved or copied.
Avoid when
The message needs action or must stay; use Alert or Dialog.

Installation

The source lands in src/components/ui/toast.tsx, along with any Shelf items it builds on, and .shelf/lock.json records what was installed. It's yours to edit.

Examples

Success and error

An icon that matches the outcome of an action.

Action

An action button, such as undo.

Promise

Follows an async task from loading to done.

Built on

Packages
@base-ui/react, @stylexjs/stylex
Shelf items
Button, foundations, Icons, Spinner
Accessibility
Focus, keyboard, and ARIA behavior come from Base UI.
Figma
Optional native Figma library. See Designers.

Verified

Size
3.1 kB gzipped on its own, 21 kB with the Shelf items and packages it builds on. JS and CSS in a production build, without React.
Accessibility
Axe passes on 9 stories
Behavior
9 interaction tests in Storybook
React Compiler
Compiles with React Compiler
React Doctor
React Doctor finds nothing