# Gummy UI public component catalogue > 57 stable, MIT-licensed React and TypeScript component categories. Each entry links to a Markdown behavior contract and its public registry payload. All entries derive from the same catalogue used by the website and machine-readable JSON API. ## Install the theme foundation ```sh npx shadcn@latest add https://gummyui.dev/r/gummy-base.json ``` ## Core guides - [Introduction](https://gummyui.dev/docs/markdown/guides/introduction.md) - [Installation](https://gummyui.dev/docs/markdown/guides/installation.md) - [Nextjs](https://gummyui.dev/docs/markdown/guides/nextjs.md) - [Vite](https://gummyui.dev/docs/markdown/guides/vite.md) - [Theming](https://gummyui.dev/docs/markdown/guides/theming.md) - [Accessibility](https://gummyui.dev/docs/markdown/guides/accessibility.md) - [Rtl](https://gummyui.dev/docs/markdown/guides/rtl.md) - [Localisation](https://gummyui.dev/docs/markdown/guides/localisation.md) - [Editor-setup](https://gummyui.dev/docs/markdown/guides/editor-setup.md) - [Mcp](https://gummyui.dev/docs/markdown/guides/mcp.md) - [Troubleshooting](https://gummyui.dev/docs/markdown/guides/troubleshooting.md) ## Foundations Type, direction, separation, loading, and media primitives. - [Aspect Ratio](https://gummyui.dev/docs/markdown/components/aspect-ratio.md): A predictable media frame that preserves a numeric ratio. Registry: https://gummyui.dev/r/gummy-aspect-ratio.json - [Direction](https://gummyui.dev/docs/markdown/components/direction.md): A scoped native direction boundary aligned with Base UI behavior. Registry: https://gummyui.dev/r/gummy-direction.json Radix registry: https://gummyui.dev/r/gummy-radix-direction.json - [Kbd](https://gummyui.dev/docs/markdown/components/kbd.md): Keyboard notation for shortcuts and key sequences. Registry: https://gummyui.dev/r/gummy-kbd.json - [Separator](https://gummyui.dev/docs/markdown/components/separator.md): A quiet horizontal or vertical divider with decorative or semantic mode. Registry: https://gummyui.dev/r/gummy-separator.json - [Skeleton](https://gummyui.dev/docs/markdown/components/skeleton.md): A decorative loading placeholder with reduced-motion fallback. Registry: https://gummyui.dev/r/gummy-skeleton.json - [Spinner](https://gummyui.dev/docs/markdown/components/spinner.md): A compact named loading indicator with reduced-motion state. Registry: https://gummyui.dev/r/gummy-spinner.json - [Typography](https://gummyui.dev/docs/markdown/components/typography.md): Headings, text, eyebrow, blockquote, and inline-code foundations. Registry: https://gummyui.dev/r/gummy-typography.json ## Forms and selection Native and custom controls with stable labels, values, and validation. - [Button](https://gummyui.dev/docs/markdown/components/button.md): The approved fruit-gel action with chewy press physics. Registry: https://gummyui.dev/r/gummy-button.json - [Button Group](https://gummyui.dev/docs/markdown/components/button-group.md): Related native buttons joined by quiet shared material. Registry: https://gummyui.dev/r/gummy-button-group.json - [Checkbox](https://gummyui.dev/docs/markdown/components/checkbox.md): A native checkbox with mixed, validation, disabled, and read-only states. Registry: https://gummyui.dev/r/gummy-checkbox.json - [Field](https://gummyui.dev/docs/markdown/components/field.md): One labelled control with descriptions, validation, and layout state. Registry: https://gummyui.dev/r/gummy-field.json - [Input](https://gummyui.dev/docs/markdown/components/input.md): A native single-line field with descriptions, adornments, and feedback. Registry: https://gummyui.dev/r/gummy-input.json - [Label](https://gummyui.dev/docs/markdown/components/label.md): A native label with required, optional, disabled, and read-only cues. Registry: https://gummyui.dev/r/gummy-label.json - [Native Select](https://gummyui.dev/docs/markdown/components/native-select.md): The platform single-select picker with Gummy shell and read-only extension. Registry: https://gummyui.dev/r/gummy-native-select.json - [Radio Group](https://gummyui.dev/docs/markdown/components/radio-group.md): A native fieldset of same-name radios with controlled state and RTL. Registry: https://gummyui.dev/r/gummy-radio-group.json - [Slider](https://gummyui.dev/docs/markdown/components/slider.md): Single or range numeric selection on a touch-safe track. Registry: https://gummyui.dev/r/gummy-slider.json Radix registry: https://gummyui.dev/r/gummy-radix-slider.json - [Switch](https://gummyui.dev/docs/markdown/components/switch.md): A binary Base UI control with one connected track and gel thumb. Registry: https://gummyui.dev/r/gummy-switch.json Radix registry: https://gummyui.dev/r/gummy-radix-switch.json - [Textarea](https://gummyui.dev/docs/markdown/components/textarea.md): A native multiline field with validation, resizing, and live count. Registry: https://gummyui.dev/r/gummy-textarea.json - [Toggle](https://gummyui.dev/docs/markdown/components/toggle.md): A pressed-state button for one independent option. Registry: https://gummyui.dev/r/gummy-toggle.json Radix registry: https://gummyui.dev/r/gummy-radix-toggle.json - [Toggle Group](https://gummyui.dev/docs/markdown/components/toggle-group.md): Single or multiple pressed choices coordinated as a labelled group. Registry: https://gummyui.dev/r/gummy-toggle-group.json Radix registry: https://gummyui.dev/r/gummy-radix-toggle-group.json ## Display and feedback Status, identity, progress, empty states, and composed content. - [Alert](https://gummyui.dev/docs/markdown/components/alert.md): Static or live feedback with a restrained status reservoir. Registry: https://gummyui.dev/r/gummy-alert.json - [Avatar](https://gummyui.dev/docs/markdown/components/avatar.md): Image, fallback, group, and named presence status. Registry: https://gummyui.dev/r/gummy-avatar.json - [Badge](https://gummyui.dev/docs/markdown/components/badge.md): A non-interactive semantic label in solid or translucent fruit material. Registry: https://gummyui.dev/r/gummy-badge.json - [Card](https://gummyui.dev/docs/markdown/components/card.md): Passive, link, and button surfaces held in one continuous gel-pocket frame. Registry: https://gummyui.dev/r/gummy-card.json - [Empty](https://gummyui.dev/docs/markdown/components/empty.md): A structured zero-state with media, title, description, and actions. Registry: https://gummyui.dev/r/gummy-empty.json - [Item](https://gummyui.dev/docs/markdown/components/item.md): A dense passive, link, or button row with media, copy, and actions. Registry: https://gummyui.dev/r/gummy-item.json - [Progress](https://gummyui.dev/docs/markdown/components/progress.md): Determinate or indeterminate task progress with a visible label. Registry: https://gummyui.dev/r/gummy-progress.json ## Navigation and disclosure Hierarchy, paging, menus, sidebars, and collapsible structure. - [Accordion](https://gummyui.dev/docs/markdown/components/accordion.md): Vertically stacked disclosure sections with coordinated open state. Registry: https://gummyui.dev/r/gummy-accordion.json Radix registry: https://gummyui.dev/r/gummy-radix-accordion.json - [Breadcrumb](https://gummyui.dev/docs/markdown/components/breadcrumb.md): Hierarchy navigation with current-page and collapsed-path parts. Registry: https://gummyui.dev/r/gummy-breadcrumb.json - [Collapsible](https://gummyui.dev/docs/markdown/components/collapsible.md): One trigger and panel for optional supporting content. Registry: https://gummyui.dev/r/gummy-collapsible.json Radix registry: https://gummyui.dev/r/gummy-radix-collapsible.json - [Context Menu](https://gummyui.dev/docs/markdown/components/context-menu.md): Secondary commands opened by context click, keyboard, or long press. Registry: https://gummyui.dev/r/gummy-context-menu.json Radix registry: https://gummyui.dev/r/gummy-radix-context-menu.json - [Dropdown Menu](https://gummyui.dev/docs/markdown/components/dropdown-menu.md): Compact commands with typeahead, submenus, and selection items. Registry: https://gummyui.dev/r/gummy-dropdown-menu.json Radix registry: https://gummyui.dev/r/gummy-radix-dropdown-menu.json - [Menubar](https://gummyui.dev/docs/markdown/components/menubar.md): Coordinated application command menus with compact scanning. Registry: https://gummyui.dev/r/gummy-menubar.json Radix registry: https://gummyui.dev/r/gummy-radix-menubar.json - [Navigation Menu](https://gummyui.dev/docs/markdown/components/navigation-menu.md): Site discovery links arranged in a shared responsive popup viewport. Registry: https://gummyui.dev/r/gummy-navigation-menu.json Radix registry: https://gummyui.dev/r/gummy-radix-navigation-menu.json - [Pagination](https://gummyui.dev/docs/markdown/components/pagination.md): Current-page navigation with previous, next, and ellipsis parts. Registry: https://gummyui.dev/r/gummy-pagination.json - [Sidebar](https://gummyui.dev/docs/markdown/components/sidebar.md): A controlled workspace shell with responsive navigation panel and inset. Registry: https://gummyui.dev/r/gummy-sidebar.json - [Tabs](https://gummyui.dev/docs/markdown/components/tabs.md): One shared selection rail coordinating labelled tab panels. Registry: https://gummyui.dev/r/gummy-tabs.json Radix registry: https://gummyui.dev/r/gummy-radix-tabs.json ## Overlays Focus-managed modal and non-modal surfaces. - [Alert Dialog](https://gummyui.dev/docs/markdown/components/alert-dialog.md): A modal confirmation surface for consequential decisions. Registry: https://gummyui.dev/r/gummy-alert-dialog.json Radix registry: https://gummyui.dev/r/gummy-radix-alert-dialog.json - [Dialog](https://gummyui.dev/docs/markdown/components/dialog.md): A modal reading plane with responsive focus containment. Registry: https://gummyui.dev/r/gummy-dialog.json Radix registry: https://gummyui.dev/r/gummy-radix-dialog.json - [Drawer](https://gummyui.dev/docs/markdown/components/drawer.md): A mobile-first bottom task surface built on modal dialog behavior. Registry: https://gummyui.dev/r/gummy-drawer.json Radix registry: https://gummyui.dev/r/gummy-radix-drawer.json - [Hover Card](https://gummyui.dev/docs/markdown/components/hover-card.md): A supporting preview for a focused or hovered link. Registry: https://gummyui.dev/r/gummy-hover-card.json Radix registry: https://gummyui.dev/r/gummy-radix-hover-card.json - [Popover](https://gummyui.dev/docs/markdown/components/popover.md): A non-modal contextual surface with title, description, and close parts. Registry: https://gummyui.dev/r/gummy-popover.json Radix registry: https://gummyui.dev/r/gummy-radix-popover.json - [Sheet](https://gummyui.dev/docs/markdown/components/sheet.md): A modal side workflow with configurable logical edge. Registry: https://gummyui.dev/r/gummy-sheet.json Radix registry: https://gummyui.dev/r/gummy-radix-sheet.json - [Tooltip](https://gummyui.dev/docs/markdown/components/tooltip.md): A short descriptive popup with shared delay and collision handling. Registry: https://gummyui.dev/r/gummy-tooltip.json Radix registry: https://gummyui.dev/r/gummy-radix-tooltip.json ## Composite inputs Dense pickers, filtering, commands, dates, and one-time codes. - [Calendar](https://gummyui.dev/docs/markdown/components/calendar.md): A locale-aware single-date grid with month navigation and constraints. Registry: https://gummyui.dev/r/gummy-calendar.json - [Combobox](https://gummyui.dev/docs/markdown/components/combobox.md): An editable option picker with filtering and collision-aware popup. Registry: https://gummyui.dev/r/gummy-combobox.json - [Command](https://gummyui.dev/docs/markdown/components/command.md): A filterable grouped action surface with decorative shortcuts. Registry: https://gummyui.dev/r/gummy-command.json - [Date Picker](https://gummyui.dev/docs/markdown/components/date-picker.md): A formatted trigger composing Gummy Popover and Calendar. Registry: https://gummyui.dev/r/gummy-date-picker.json - [Input Group](https://gummyui.dev/docs/markdown/components/input-group.md): Native input, addons, and real button actions in one shell. Registry: https://gummyui.dev/r/gummy-input-group.json - [Input OTP](https://gummyui.dev/docs/markdown/components/input-otp.md): Four to eight numeric slots with paste distribution and form value. Registry: https://gummyui.dev/r/gummy-input-otp.json - [Select](https://gummyui.dev/docs/markdown/components/select.md): A non-editable custom picker for richer option content. Registry: https://gummyui.dev/r/gummy-select.json Radix registry: https://gummyui.dev/r/gummy-radix-select.json ## Data and utilities Tables, carousels, resizing, scrolling, and notifications. - [Carousel](https://gummyui.dev/docs/markdown/components/carousel.md): Controlled or uncontrolled labelled slides with finite or looping movement. Registry: https://gummyui.dev/r/gummy-carousel.json - [Data Table](https://gummyui.dev/docs/markdown/components/data-table.md): A generic typed table with filtering, sorting, paging, and selection. Registry: https://gummyui.dev/r/gummy-data-table.json - [Resizable](https://gummyui.dev/docs/markdown/components/resizable.md): A bounded two-panel split with pointer and keyboard control. Registry: https://gummyui.dev/r/gummy-resizable.json - [Scroll Area](https://gummyui.dev/docs/markdown/components/scroll-area.md): A native scroll viewport with custom overflow-only scrollbars. Registry: https://gummyui.dev/r/gummy-scroll-area.json Radix registry: https://gummyui.dev/r/gummy-radix-scroll-area.json - [Sonner](https://gummyui.dev/docs/markdown/components/sonner.md): Polite or urgent toast workflows with actions, promises, and swipe dismissal. Registry: https://gummyui.dev/r/gummy-sonner.json Radix registry: https://gummyui.dev/r/gummy-radix-sonner.json - [Table](https://gummyui.dev/docs/markdown/components/table.md): Composable native table sections, captions, rows, headers, and cells. Registry: https://gummyui.dev/r/gummy-table.json ## Machine-readable resources - Catalogue JSON: https://gummyui.dev/api/catalogue - Registry index: https://gummyui.dev/registry - Registry payload pattern: https://gummyui.dev/r/{registry-name}.json - Agent index: https://gummyui.dev/llms.txt ## Licence and source boundary Gummy UI's public component source and documentation are MIT licensed. This Markdown namespace exposes only public catalogue facts, public source locations, and public registry URLs. Separate paid assets are not included and cannot be inferred from these documents. Canonical Markdown: https://gummyui.dev/docs/markdown/catalogue.md