saturation/uisaturation/ui
DocsComponentsBlocksPagesEmails
GitHub

Sections

IntroductionComponentsInstallationMCPThemingDesign

Components

Components

General

AvatarBadgeButtonKbdProgressSeparatorSkeletonSpin ResolveSpinnerSync ButtonTypography

Forms & Inputs

Address LookupCalendar PickerCheckboxComboboxDate PickerEmoji PickerFavicon SearchFieldInputInput GroupInput OTPRadio GroupSelectSliderSwitchTextareaToggleToggle Group

Data Display

AccordionAlertCardChartComparison SliderCredit CardData TableEmptyItemSaturation Credit CardTableTree

Navigation

BreadcrumbCommandMenubarNavigation MenuPaginationTabs

Overlays

CollapsibleContext MenuDialogDropdown MenuSheet

Layout

Button GroupFont ProviderWizard Split Layout

Feedback

Sonner

Animation & Effects

Animated GroupAnimated ListAnimated NumberBeamBlur FadeBorder TrailGlow EffectLiquid MetalLoading StateParallaxPixelProgressive BlurRippleSpotlightText EffectText Shimmer

Productivity

Agent ChatAI Chat InputCoding AgentFiltersFull CalendarKanbanNovel Editor
Docs/Components/Button Group

Button Group

Groups related buttons together.

Loading...

Installation

pnpm dlx shadcn@latest add @saturation-ui/button-group

Tailwind v4 — Source Scanning

The public shadcn registry installs component source into your project. If Tailwind v4 isn't scanning your components directory, add this to your CSS entry file:

@source "../components";

This ensures all utility classes in CVA variants and data attribute selectors are included in your build.

Usage

import { ButtonGroup } from "@/components/ui/button-group"
<ButtonGroup>
  <Button>Left</Button>
  <Button>Middle</Button>
  <Button>Right</Button>
</ButtonGroup>

Examples

Orientation

Loading...
Horizontal and vertical layouts.

Separator

Loading...
Buttons with separator.

Split

Loading...
Split button pattern.

With Tooltips

Loading...
Icon buttons with tooltips.

With Dropdown

Loading...
Create a split button group with a DropdownMenu component.

API Reference

PropTypeDefaultDescription
childrenReact.ReactNode—Button elements.
orientation"horizontal" | "vertical""horizontal"Group orientation.
PreviousBreadcrumbNextButton

On This Page

  • Installation
  • Usage
  • Examples
  • Orientation
  • Separator
  • Split
  • With Tooltips
  • With Dropdown
  • API Reference

Horizontal

Vertical