Components
Of shadcn/ui's 65 components, the kit matches 13, partly matches 37, maps 6 conversation pieces to its own patterns, and has 8 still to build. It adds 27 of its own.
Layout
- Accordion: A stack of headings that each reveal a section of content. One section is open at a time.
- Browser Frame: Browser chrome with an address bar, for framing live previews and pages an agent has built.
- Collapsible: A single heading that shows or hides the content beneath it.
- Dot Grid: A dotted canvas background that fills its nearest positioned parent. Used behind workflow builders and diagrams.
- Phone Frame: A handset bezel for framing mobile screens, drawers and sheets. Width and height are props.
- Scroll Area: A container with a maximum height that scrolls its content with a thin, theme-coloured scrollbar.
- Separator: A one pixel horizontal rule between groups of content. Exported as Divider, with Separator as an alias.
- Stack: A flex container that lays out children in a column or a row with a gap from the spacing scale.
- Typography: Text primitives on the kit's type scale: body text, six heading levels, captions and inline code.
Agents
- Agent Glyph: A round accent mark with a spark, used as the agent's avatar beside messages and activity.
- AI Suggestion Badge: An accent badge that marks content as suggested by the agent. Fixed text, no props.
- Chat History: The sidebar list of past threads, grouped under Pinned, Today, Yesterday and Earlier, with search, a new-chat button and a quiet per-row menu to rename, pin or delete.
- Chat Input: The composer for an agent conversation: a growing text field with suggestion chips, removable attachments, a model pill, a mic button and a send button that becomes Stop while the agent streams.
- Confidence Bar: A labelled bar for how sure the agent is. Green above 80, amber above 50, red at 50 and below.
- Conversation: The scrolling thread of an agent chat, built from Message: it follows new turns until the reader scrolls up, then offers a Jump to latest pill, and shows the agent's thinking indicator while a reply is on its way.
- Message: One turn in an agent conversation: user turns sit right in a bubble, agent turns sit left beside the agent's mark with sources and quiet actions, system turns are a centred line.
- Orb: A small animated glyph that shows what an agent is doing. Five variants, any size, bare or as a labelled pill.
- Question Card: The agent asks several questions before it continues: one at a time with a count, lettered options, an optional free-text answer and a summary at the end.
- Reasoning Steps: A dense trace of what the agent did, with a glyph per kind of step and a duration on each. Open while it runs, folded to one summary line when done.
- Task List: The agent's running to-do list for one job: a count, a slim progress bar and one row per task with to do, running, done, failed and blocked states.
- Thinking Indicator: A short label with three pulsing dots, shown while an agent is working. Two sizes.
- Thinking Steps: A vertical list of the steps an agent is working through, with done, active and upcoming states.
- Trace Waterfall: An agent run on a timeline: totals for duration, cost, tokens and calls, a legend of span kinds, and one bar per span nested under its parent, with a detail line for the span under the pointer or focus.
Feedback
- Alert: An inline banner with a title and a description, in default, success, warning and danger variants.
- Empty: A centred placeholder for a view with nothing in it: icon, title, description and one action.
- Progress: Shows how far a task has come, as a bar or as a ring with an optional label in the middle.
- Skeleton: A shimmering placeholder block that holds the shape of content while it loads.
- Spinner: A small spinning ring for work with no known length.
- Toast: A short message in a floating pill, in default, success, warning and danger variants.
Overlays
- Alert Dialog: A modal that interrupts to confirm a consequential action, with danger, warning and info variants.
- Command: A searchable list of actions. CommandPalette (alias Command) renders inline, CommandMenu opens it as a modal.
- Context Menu: A menu of actions that opens at the pointer when its children are right clicked.
- Dialog: A modal window over the page. Dialog holds plain content, FormDialog wraps fields in a form, CardDialog adds a cover and custom actions.
- Dropdown Menu: A menu of actions that opens below a trigger, with icons, separators and a danger style.
- Hover Card: A floating card of preview content shown while the pointer is over its trigger.
- Popover: A floating panel anchored below a trigger, for short forms, settings and details.
- Sheet: A panel that slides in from the left or right edge of the screen over a scrim.
- Tooltip: A short text label that appears above an element on hover.
Content
- Attachment: A file chip or card for things attached to a message or a composer, with a tinted letter glyph per file kind and upload progress.
- Avatar: Shows a person as a photo or as coloured initials, alone or in an overlapping group.
- Badge: A small label for state or category. Badge has five colour variants and StatusBadge adds a status dot.
- Card: A glass surface that groups related content, with an optional header for a title, subtitle and action.
- Chart: A small trend line drawn in plain SVG, with an optional area fill and a dot on the latest value.
- Chip: A compact pill that toggles on and off for filters, or carries a remove control for picked values.
- Compare Slider: Shows two versions of the same thing, either side by side behind a draggable divider or one at a time behind a switch.
- Data Table: A table with sortable column headers and row selection built in.
- File Tree: A collapsible tree of folders and files with optional badges, for showing what a coding agent touched.
- Item: A row with a title, an optional subtitle, and slots on the left and right for media and actions.
- Kbd: Shows a keyboard key or shortcut in a small keycap.
- Marker: The small inline citation marker inside a sentence that previews its source on hover or focus and opens it on click.
- Middle Truncate: Shortens a long identifier in the middle so its start and end stay readable.
- Snippet: A single-line command with a prompt character and a copy button.
- Stat: A labelled number with an optional change that is coloured and arrowed by direction.
- Status Dot: A small coloured dot for online, busy, error, offline and accent states, with an optional pulse.
- Table: A simple table drawn from a list of columns and a list of rows, with a hover state on each row.
- Tag: A pill label with an optional colour dot and a remove button.
Navigation
- Breadcrumb: Shows where a page sits in the hierarchy, with an optional home icon and a collapsed middle for long trails.
- Menubar: A row of menus, like a desktop application bar. Open one, then move across the others by hovering.
- Pagination: Moves through pages of results. A compact counter with previous and next, or a row of dots.
- Stepper: Shows progress through a fixed sequence of steps, with done, current and upcoming states.
- Tabs: Switches between views in the same context. Tabs is an underlined row, SubtleTabs is a compact pill group.
- Zoom Control: A minus button, a percentage and a plus button. Steps by 10 between 25 and 200 percent.
Forms
- Button: Triggers an action. Six variants and four sizes, with icon, loading and disabled states.
- Button Group: Joins related buttons into one bordered row with a hairline between each.
- Calendar: A month grid for picking a single date, with today marked and previous and next month controls.
- Checkbox: A box that turns an option on or off, with an animated tick, a label and a disabled state.
- Choicebox: A stack of selectable cards, each with a title, an optional description and a meta label. Single or multiple choice.
- Combobox: A select with a filter field: type to narrow the options, then pick one.
- Copy Input: A read-only field with a copy button, for API keys, webhook URLs and share links.
- Date Picker: A field that opens a Calendar and shows the chosen date in short form.
- Field: The kit has no separate Field wrapper. TextInput, TextArea and Select carry their own label, and the text fields add a caption and an error message.
- Input: A single-line text field with a built-in label, caption, error, leading icon and three sizes. Exported as TextInput and as Input.
- Input Group: A text field with a fixed prefix, suffix or both inside one border.
- Input OTP: A row of single-character boxes for a one-time code. Focus moves forward as each box fills.
- Label: A small text label for a form control, with an optional required marker.
- Radio Group: A vertical list of options where one is selected. Radio is the single item, with an animated dot.
- Rating: A row of stars for giving or showing a score. Configurable maximum and size, with a read-only mode.
- Search Input: A compact search field with a leading icon, a keyboard shortcut hint and a clear button once there is a value.
- Segmented Control: Switches between a few views or modes, with a thumb that slides to the active segment.
- Select: A dropdown for picking one value from a short list. Options are strings or value and label pairs.
- Slider: Picks a number in a range. Slider is a native range input with a value readout. SpringSlider adds a thumb that grows and settles with a spring.
- Split Button: A main action joined to a chevron that opens a menu of related actions.
- Switch: Turns a setting on or off at once. Exported as SwitchToggle and as Switch. SpringToggle adds a thumb that stretches while pressed.
- Textarea: A multi-line text field with a built-in label and caption. It resizes vertically. Exported as TextArea and as Textarea.
- Toggle: A button that stays pressed, for a single on or off option such as a filter.
- Toggle Group: A joined row of toggles. Pass a string for one active option or an array for several. Your handler decides the next value.
Generative UI
- Document Agent: A document the agent edits beside you: each suggested change shows the old text struck through and the new text beside it, with Accept and Reject inline.
- Media Generation: The waiting, progress and result states for a generated image or video, in a frame that keeps its aspect ratio throughout.
- Result Cards: A row or grid of result cards the agent returns inside a reply, one shape for products, places, people and documents.
- Streaming Text: Types text out one character at a time with a blinking cursor, then hides the cursor when it finishes.
Halaska UI · Components · Patterns · Screens · Install