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.

Roadmap

Shelf is early. Everything the site describes is on one of these two lists.

Available

106 components
React, Base UI, and StyleX, each with a live demo in these docs.
12 blocks
Finished pieces of a page, such as a login form, that install the components they use.
Foundations and themes
Semantic tokens for color, type, spacing, radius, and motion, with light, dark, and presets.
shelf init
Configuration, path aliases, and the provenance record.
shelf search
Find items in a registry, best match first, with when to use each and what to use instead.
shelf add
Copy source, resolve Shelf dependencies, install packages, and record provenance. Never overwrites your changes.
shelf status
Which installed items you changed and which have a newer version.
shelf diff
What an update brings, or what you changed, since you installed an item.
shelf update
A three-way update from BASE, LOCAL, and UPSTREAM, with conflict markers where both changed the same lines.
shelf check
Provenance with local changes and unresolved conflicts, dependencies, and imports of installed items.
Private registries
Request headers from environment variables, sent only over HTTPS.
shelf build
Validate and publish a registry with every past revision, served with shelf serve or any static host.
Registry site
The built registry is also a site: every item with its source, revisions, Storybook previews, and usage.
Figma library
A plugin that builds native Figma variables, styles, and components from your registry and syncs changes. Optional, and installed privately for now.
shelf usage
Which projects install and import each item, at which revision, across local directories or a GitHub organization.

Planned

contribute
Send a local improvement back to the registry.
More patterns and templates
Only the interactions and pages that products turn out to need. There is one pattern and two templates so far.
Decisions that propagate
Change one approved decision and have the products that use it follow, with a person reviewing how it lands.
Recorded rationale
The reason behind a change stored next to the revision, not only the diff.
Visual validation
Deterministic captures and structured differences in shelf check.

Shelf grows through real product use, so this list moves when something proves itself, not on a schedule.