Buttons, a field or a menu joined into one strip: split buttons, steppers, prev / next, search with scope.
Button group basic
Install
npx shadcn add @syncrobotic/button-group Also installs: radix-ui, @syncrobotic/cn
Overview
A strip of joined controls that reads as one: neighbours share an edge and only the outer corners are round.
When to use
- A split button: the main action and a menu of variants.
- A stepper: minus, value, plus.
- Prev and next, zoom in and out, playback controls.
- A search field with its scope menu and button.
Use something else
- One choice among several that stays selected: Toggle group or Segmented control.
- Unrelated actions in a toolbar: separate buttons with a gap.
More examples
States and real uses. Each example is also a Storybook story and a visual regression test.
Button group icon tools
Button group split button
Button group stepper
Button group pagination
Button group with input
Button group count
Button group playback
Button group zoom
Button group separate danger
Usage rules
- Holds no selection; for one choice among several use Segmented control or Toggle group.
- Keep destructive actions outside the group.
- Give the group an aria-label.
Changelog
- 0.9.02026-11-17New.