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.

Button Group

Joins related Buttons into one row that shares borders.

When to use

Use when
A few related actions that belong together, such as a split button or segmented actions.
Avoid when
The buttons select a value; use Toggle Group.

Installation

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

Usage

Examples

Split button

A main action with a menu of related ones.

Sizes

Buttons in a group should share one size.

Built on

Packages
@stylexjs/stylex
Shelf items
utils
Figma
Optional native Figma library. See Designers.

Verified

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