# Siteplane UI

> Canonical machine-readable contracts for selecting, installing and composing Siteplane UI.

> Siteplane UI release `0.1.1`.

## Core

- [Full Context](https://ui.siteplane.io/llms-full.txt): All canonical component and pattern contracts.

- [Registry Catalog](https://ui.siteplane.io/r/registry.json): Searchable shadcn registry metadata.

## Components

- [Accordion](https://ui.siteplane.io/llms/components/accordion.md): Accordion organizes several short, scannable disclosure panels that can open independently or as a controlled group.

- [Alert](https://ui.siteplane.io/llms/components/alert.md): Alert presents important inline information, success, warning, or error feedback in the content flow.

- [Alert Dialog](https://ui.siteplane.io/llms/components/alert-dialog.md): Alert Dialog asks users to confirm a blocking or destructive decision before the application continues.

- [Animated Buttons](https://ui.siteplane.io/llms/components/animated-buttons.md): Animated button components for fill, directional and label-reveal interactions.

- [Autocomplete](https://ui.siteplane.io/llms/components/autocomplete.md): Remote user suggestions and other async results while a user types, with free-text input for search and tagging.

- [Avatar](https://ui.siteplane.io/llms/components/avatar.md): Avatar represents a person, team, or account with an image and a reliable text fallback.

- [Badge](https://ui.siteplane.io/llms/components/badge.md): Badge presents short status, label, or count information that helps people scan an interface.

- [Breadcrumb](https://ui.siteplane.io/llms/components/breadcrumb.md): Breadcrumb shows the current resource within a hierarchy and links back to its parent levels.

- [Button](https://ui.siteplane.io/llms/components/button.md): Button is the standard control for visible actions, with built-in variants, sizes, loading behavior, and accessible disabled states.

- [Calendar](https://ui.siteplane.io/llms/components/calendar.md): Calendar wraps React DayPicker for single-date, multiple-date, and date-range selection.

- [Card](https://ui.siteplane.io/llms/components/card.md): Card groups related content, actions, forms, or framed data into a clear surface.

- [Checkbox](https://ui.siteplane.io/llms/components/checkbox.md): Checkbox represents a Boolean choice or one option within a multi-select group.

- [Checkbox Group](https://ui.siteplane.io/llms/components/checkbox-group.md): Checkbox Group lets users select any number of options from a related set.

- [Code / CodeBlock](https://ui.siteplane.io/llms/components/code.md): Code formats short inline tokens, while CodeBlock presents multiline or copyable snippets.

- [Collapsible](https://ui.siteplane.io/llms/components/collapsible.md): Collapsible controls one expandable section, such as a disclosure, show-more block, or sidebar group.

- [Color Picker](https://ui.siteplane.io/llms/components/color-picker.md): Color Picker lets users choose and submit short hexadecimal color values through a visual control.

- [Combobox](https://ui.siteplane.io/llms/components/combobox.md): Combobox provides searchable single- and multi-select lists, including chip-based selection.

- [Command](https://ui.siteplane.io/llms/components/command.md): Command combines a dialog and autocomplete list for fast keyboard-driven navigation, search, and actions.

- [Context Menu](https://ui.siteplane.io/llms/components/context-menu.md): Context Menu presents secondary actions at the pointer after a right click or long press.

- [Data Table](https://ui.siteplane.io/llms/components/data-table.md): A sortable project table with typed columns, active rows, row actions and empty states.

- [Date Picker](https://ui.siteplane.io/llms/components/date-picker.md): Date Picker composes Button, Popover, and Calendar into an accessible single-date selection pattern.

- [Dialog](https://ui.siteplane.io/llms/components/dialog.md): Dialog focuses attention on a decision, short form, or other modal task.

- [Drawer](https://ui.siteplane.io/llms/components/drawer.md): Drawer provides swipeable edge panels for mobile menus, contextual details, and gesture-driven flows.

- [Dropdown Menu](https://ui.siteplane.io/llms/components/dropdown-menu.md): Dropdown Menu provides the shadcn-compatible alias API for short action lists anchored to a trigger.

- [Empty](https://ui.siteplane.io/llms/components/empty.md): Empty explains a genuine no-content state and can provide a clear next action.

- [Field](https://ui.siteplane.io/llms/components/field.md): Field connects one form control with its label, description, validation state, and error message.

- [Fieldset](https://ui.siteplane.io/llms/components/fieldset.md): Fieldset groups related form fields under a shared semantic legend.

- [Form](https://ui.siteplane.io/llms/components/form.md): Form coordinates related fields, submission, validation, and server errors in one accessible workflow.

- [Frame](https://ui.siteplane.io/llms/components/frame.md): Frame structures app surfaces such as settings panels, statistics, lists, and empty states.

- [Group](https://ui.siteplane.io/llms/components/group.md): Group joins related controls into one visual cluster with shared borders and connected radii.

- [Icon Morphs](https://ui.siteplane.io/llms/components/icon-morphs.md): An installable menu icon control that morphs between hamburger and close states.

- [Input](https://ui.siteplane.io/llms/components/input.md): Input is the standard control for short free-text values, search fields, and compact form data.

- [Input Group](https://ui.siteplane.io/llms/components/input-group.md): Input Group combines an input or textarea with tightly related icons, units, text, shortcuts, or inline actions.

- [Kbd](https://ui.siteplane.io/llms/components/kbd.md): Kbd displays individual keys or short keyboard shortcuts without replacing explanatory help.

- [Label](https://ui.siteplane.io/llms/components/label.md): Label gives one form control a visible, clickable name through htmlFor or wrapper semantics.

- [Menu](https://ui.siteplane.io/llms/components/menu.md): Menu presents grouped actions, choices, links, and submenus from a trigger button.

- [Meter](https://ui.siteplane.io/llms/components/meter.md): Meter communicates a known numeric value within a fixed range, such as usage, capacity, a rating, or a quota.

- [Number Field](https://ui.siteplane.io/llms/components/number-field.md): Numeric input with keyboard entry, step controls, range constraints, formatting and optional scrubbing.

- [OTP Field](https://ui.siteplane.io/llms/components/otp-field.md): Fixed-length segmented input for one-time passwords, verification codes and recovery codes.

- [Pagination](https://ui.siteplane.io/llms/components/pagination.md): Accessible page-based navigation with active links, previous and next controls, and skipped ranges.

- [Popover](https://ui.siteplane.io/llms/components/popover.md): Contextual information, compact actions and lightweight forms anchored to a trigger.

- [Preview Card](https://ui.siteplane.io/llms/components/preview-card.md): Optional profile, repository, term or product previews shown from a hoverable and focusable trigger.

- [Progress](https://ui.siteplane.io/llms/components/progress.md): Determinate progress with labels, formatted values, sizes and a token-driven indicator transition.

- [Radio Group](https://ui.siteplane.io/llms/components/radio-group.md): Single-select controls for choosing exactly one option from a short visible list.

- [Resource List](https://ui.siteplane.io/llms/components/resource-list.md): Compact entity lists with structured status, content and metadata but no tabular header.

- [Scroll Area](https://ui.siteplane.io/llms/components/scroll-area.md): Bounded overflow regions with keyboard scrolling, overlay scrollbars and optional edge fades.

- [Select](https://ui.siteplane.io/llms/components/select.md): A small known set of options for single or multiple selection without text search.

- [Selectable Card](https://ui.siteplane.io/llms/components/selectable-card.md): A card-shaped button with controlled selected state, keyboard focus and pressed semantics.

- [Separator](https://ui.siteplane.io/llms/components/separator.md): Horizontal or vertical separation for meaningful boundaries between related content groups.

- [Sheet](https://ui.siteplane.io/llms/components/sheet.md): An edit form from the side in a dialog-based edge flyout for create, edit and save-or-cancel workflows.

- [Skeleton](https://ui.siteplane.io/llms/components/skeleton.md): Content-shaped loading placeholders with a shared shimmer and stable layout dimensions.

- [Slider](https://ui.siteplane.io/llms/components/slider.md): Single-value and range selection across a continuous or stepped visual scale.

- [Spinner](https://ui.siteplane.io/llms/components/spinner.md): Indeterminate loading status for saving, refreshing and bounded asynchronous work.

- [Stepper](https://ui.siteplane.io/llms/components/stepper.md): Read-only or interactive ordered workflow progress with open, current, done and blocked states.

- [Switch](https://ui.siteplane.io/llms/components/switch.md): Direct on-or-off preferences with native form state, labels, sizes and reduced-motion support.

- [Table](https://ui.siteplane.io/llms/components/table.md): Semantic tabular data with structured headers, cells, selection and interactive-row support.

- [Tabs](https://ui.siteplane.io/llms/components/tabs.md): Equal-priority panels within one local page context, with horizontal and vertical orientation.

- [Textarea](https://ui.siteplane.io/llms/components/textarea.md): Multi-line free-form input for notes, comments and longer descriptions.

- [Theme Toggles](https://ui.siteplane.io/llms/components/theme-toggles.md): Two installable animated sun and moon controls for switching themes.

- [Timeline](https://ui.siteplane.io/llms/components/timeline.md): Read-only chronological history with structured titles, descriptions and semantic status markers.

- [Toast](https://ui.siteplane.io/llms/components/toast.md): Temporary success feedback and other brief, dismissible status messages after a real user action.

- [Toggle](https://ui.siteplane.io/llms/components/toggle.md): A two-state pressed button for actions such as bookmarks, mute and text formatting.

- [Toggle Group](https://ui.siteplane.io/llms/components/toggle-group.md): Related toggle buttons with shared single-select or multi-select state.

- [Toolbar](https://ui.siteplane.io/llms/components/toolbar.md): A compact roving-focus group for equal-priority buttons, toggles, links and lightweight controls.

- [Tooltip](https://ui.siteplane.io/llms/components/tooltip.md): Short, non-essential hints shown from hover or focus without replacing the trigger's accessible name.

## Patterns

- [Dashboard Shell](https://ui.siteplane.io/llms/patterns/dashboard-shell.md): A dashboard layout with Sidebar, app header and dedicated content scroll region.

- [Destructive Confirmation](https://ui.siteplane.io/llms/patterns/destructive-confirmation.md): A destructive account action with explicit cancellation, confirmation and result status.

- [Detail Drawer](https://ui.siteplane.io/llms/patterns/detail-drawer.md): Inspect row details in a side panel without entering an edit workflow.

- [Filter Bar](https://ui.siteplane.io/llms/patterns/filter-bar.md): Search and filters above a table, with active-filter badges and a clear action.

- [Settings Switch Rows](https://ui.siteplane.io/llms/patterns/settings-switch-rows.md): Labelled settings rows with descriptions, icons and a full-row switch target.

- [Sidebar](https://ui.siteplane.io/llms/patterns/sidebar.md): Application navigation composition built from Siteplane UI primitives.

- [Sortable Data Table](https://ui.siteplane.io/llms/patterns/sortable-data-table.md): A sortable project table with full-cell sort targets and an active clickable row.

- [Task Calendar](https://ui.siteplane.io/llms/patterns/task-calendar.md): An operational planning matrix with week columns, clickable day cells, task previews and day details.

- [Validated Form](https://ui.siteplane.io/llms/patterns/validated-form.md): A submitted form with loading, server validation errors and a visible result status.