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.

Icons

The icons Shelf components use, in one file you own. lucide-react by default; swap the imports to change libraries.

When to use

Use when
Supporting a label with a familiar symbol, or marking state.
Avoid when
The icon would be the only label for an unfamiliar action; add text or a Tooltip.

Installation

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

Built on

Packages
lucide-react
Shelf items
None
Figma
Optional native Figma library. See Designers.

Verified

Size
1.5 kB gzipped on its own, 7.7 kB with the Shelf items and packages it builds on. JS and CSS in a production build, without React.
Accessibility
Axe passes on 1 story
Behavior
1 interaction test in Storybook
React Compiler
Compiles with React Compiler
React Doctor
React Doctor finds nothing