GPUI Deck

Coverage and status

Reference catalogue checked **2026-11-21**: shadcn/ui All Components.

Reference catalogue checked 2026-11-21: shadcn/ui All Components. Its main catalogue contains 66 entries, each listed once below. The separate AI Elements catalogue is outside this comparison; conversation components already in the main catalogue remain included.

GPUI Deck documents 42 public library families and 23 copyable presentation/composition recipes, supplying 65 distinct implementations. The remaining catalogue entry, Native Select, is explicitly mapped to Select for GPUI. All 66 reference entries have an implemented scope or platform mapping below; none remains unassigned or Pending.

This is catalogue coverage, not complete shadcn/ui feature parity. Each contract has explicit limits, and the HTML-specific mapping does not implement a browser control or an operating-system picker. These counts do not measure performance, accessibility conformance, or completion of native desktop validation.

The target is comparable application-building breadth: shared behavior in the library, and reusable presentation and screen compositions whose source belongs to the application. The groups below describe our implementation responsibilities, not shadcn's internal architecture. The two_styles and catalogue native examples use the reusable presentation recipes. Recipe source is distributed in this repository; a local source CLI installs recipes, dependencies, tokens and license into consumer-owned modules. A remote registry is not provided.

Status meanings

  • Available: a public family and consumer example cover the stated scope.
  • Recipe: reusable application source and a working consumer example cover the stated presentation; the recipe is outside the library's public exports.
  • Mapped: an explicit GPUI platform equivalent supplies the native application need; the browser-only contract is documented instead of hidden behind an alias.

Behavior and semantic foundations

These components own interaction, state, focus, or a reusable semantic contract. Their appearance remains application-owned. Exact implemented APIs are described in the form guide, navigation and overlay guide, and layout and data guide.

Catalogue entryStatusCurrent scope or gap
AccordionAvailableFixed items, single/multiple open sections, independent header navigation, and active-only panels.
Alert DialogAvailableAlertDialog reuses Dialog state and focus; backdrop dismissal is blocked and confirmation belongs to the application.
BreadcrumbAvailableNamed native Navigation, List, and ListItem structure with aria_current(Page) on the current item. Collapsed ancestors and per-crumb dropdowns compose an ordinary DropdownMenu inside an item, as in the catalogue's Home › … › page path. The application supplies its path, ancestor Buttons, navigation callbacks, separators, collapse policy and styling; no routing, width measurement or focus controller.
ButtonAvailableNative pointer/keyboard activation, disabled state, focus, accessible naming, and explicit current-page metadata independent of selected styling; content and styles belong to the application. The optional source recipe supplies six button variants.
CheckboxAvailableControlled checked/unchecked/mixed state; the application supplies its indicator and label presentation.
CollapsibleAvailableOne retained disclosure, Button trigger, active-only content, and focus handling when content closes.
ComboboxAvailableEditable single/multiple selection, grouped results, removable selected values and replaceable items that preserve native query/focus/IME and surviving choices. Fetching/request ordering remain application-owned; no free-form values or network manager.
CommandAvailableReplaceable command items, named result groups, ranked in-order (fuzzy) matching with word-start priority and contiguous groups, keyboard/pointer actions and Dialog composition. Native query and a surviving highlight are preserved on item replacement; fetching is application-owned.
Context MenuAvailableSecondary-click and keyboard opening, focusable target, shared plain/checked/mixed/radio commands and nested submenus with leaf dispatch, dismissal and focus restoration. Values are application-owned. A touch long press opens the menu at the press position. Target content is noninteractive.
DialogAvailableModal open/close, native modal flag, background pointer/wheel isolation with or without a decorative backdrop, initial focus, containment, dismissal and return focus; the application supplies its surface and contents.
DirectionAvailableScoped DirectionProvider, nested overrides, logical row layout, and inherited horizontal navigation for Tabs, RadioGroup, ToggleGroup, Slider, Carousel, Chart, Menubar and NavigationMenu. Slider pointer geometry also mirrors. Application layout uses Direction::row; GPUI owns text shaping and editing.
Dropdown MenuAvailableButton entry to shared menus, application-controlled checked/mixed/radio semantics, enabled-item navigation, single-character search and nested submenu navigation. Leaf activation closes the menu tree before emitting one root action; no second selection store.
FieldAvailableLabel focus, help/error descriptions, and required/invalid metadata for existing Input/Textarea-based controls, including a Combobox query. ControlField gives Checkbox, Switch, RadioGroup and Select the same label, error-before-help description and required/invalid metadata, with label clicks that focus and optionally activate the control. Validation remains application-owned.
Hover CardAvailableNoninteractive rich preview on delayed hover or trigger focus, delayed closing across trigger/card pointer travel, dismissal, disabled state, and retained-state unmount cleanup. Opening and dismissal preserve existing focus. A touch long press previews immediately without activating the trigger, until the next press. Interactive preview controls are not supplied.
InputAvailableSingle-line editing, selection, clipboard, focus, and the native input interface through the retained editing engine.
Input OTPAvailableOne retained numeric editor with application-rendered slots, selection, clipboard, deletion, undo, disabled/read-only states and completion events. Full resulting pasted value must fit and contain ASCII digits; no transport or code verification.
LabelAvailableNamed native plain-text label with click-to-focus through a supplied existing FocusHandle, an explicit disabled flag, and no additional Tab stop. The application keeps the target mounted and supplies its accessible name and matching disabled state. No activation forwarding or native labelled-by relationship; Field retains its richer text-input association.
MenubarAvailableCoordinated top-level menus with one Tab entry, logical Left/Right and Home/End movement, Down/Up opening, open-menu pointer switching and shared Menu command semantics.
Native SelectMappedUse the GPUI Select to choose one value from application-supplied options, with keyboard input, disabled options and native accessibility metadata. Browser form submission and the OS picker UI remain platform-specific.
Navigation MenuAvailableNamed navigation with destination Links, explicit disclosure entries, coordinated popups, roving focus, logical arrows and open-menu pointer switching. Popup contents remain ordinary groups with normal Tab traversal; navigation destinations are application-owned.
PopoverAvailableNon-modal content with corner or collision-aware side/alignment placement, retained open state, dismissal, normal focus traversal, and return focus.
ProgressAvailableControlled known progress or an indeterminate state; the application owns fill geometry and animation.
Radio GroupAvailableFixed items, exclusive selection, roving Tab entry, and immediate arrow selection.
ResizableAvailableTwo or more panels, horizontal/vertical arrangement, per-panel fractional and measured pixel limits with refitting on resize, cascading pointer/keyboard resizing, collapsible panels with snap, Enter toggle and size restore, programmatic layout restore for application-stored sizes, and native splitter values. The storage location is application-owned.
Scroll AreaAvailableNative viewport with existing overlay scrollbar, vertical/horizontal/both axes, retained offsets, and scoped descendant reveal. No virtualization, streaming anchoring, or separate keyboard scroll focus.
SelectAvailableThe ordered list can be replaced while mounted. Selection and the open cursor follow surviving enabled values. Home/End, arrows and typeahead reveal the active row. Enter commits, and Escape returns to the trigger.
SeparatorAvailableHorizontal/vertical, semantic or decorative separation; the application supplies its visual style.
SliderAvailableOrdered single/range/multiple values with per-thumb focus and numeric semantics, nearest-thumb pointer adjustment, noncrossing steps, vertical and RTL geometry.
SwitchAvailableControlled boolean state, native activation, disabled state, and focus; the application supplies track and thumb.
TabsAvailableFixed items, automatic or manual activation, orientation-aware navigation, and active-only panels.
TextareaAvailablePublic multiline renderer over the existing TextareaState editing engine; no second editor implementation.
ToastAvailableRetained notification lifetime and explicit/timeout dismissal; hover, contained focus and inactive windows pause remaining time. Showing never takes focus; explicit focused dismissal restores prior focus. ToasterState stacks application-owned values with a visible limit, waiting older entries, in-place replacement, dismiss-all and explicit focus entry. Applications own message, actions, placement and type styling.
ToggleAvailableControlled pressed state composed from Button's activation and focus behavior.
Toggle GroupAvailableFixed items with multiple or optional single selection and roving focus; moving focus does not change the pressed values.
TooltipAvailablePlain-text native description for a Button with optional noninteractive rich visible content, delayed pointer hover, immediate keyboard focus, Escape dismissal, and native GPUI tooltip positioning. Interactive tooltip content and touch long-press behavior are not included; interactive previews belong in HoverCard or Popover.

Presentation and composition recipes

These entries primarily need reusable source compositions with consistent visual defaults and appropriate semantics. Existing GPUI layout and controls should do the work; adding a new state controller for each visual name is unnecessary. The published recipes live in crates/base/examples/recipes, keep visual styling in the consumer, and are composed into the native two-style example.

Catalogue entryStatusCurrent scope or gap
AlertRecipeInline title/description, default informational Note semantics, explicit urgent Alert semantics, and independent destructive styling. No notification queue, dismissal state, or live-region delivery controller.
Aspect RatioRecipeFinite positive width/height ratio through GPUI layout, a width-controlled frame, and clipped application-owned content. The wrapper adds no role, name, or focus stop; media semantics and object fit belong to its children. Explicit height or min/max constraints follow GPUI's ordinary layout rules.
AvatarRecipeNamed circular image with explicit application-supplied fallback text for absent, pending, or failed sources. GPUI owns loading, its loading delay, and caching; the wrapper preserves one Image name and no focus stop. AvatarGroup overlaps avatars, limits the visible count and names hidden people through a "+N" Label. No initials generator, status badge, or separate loading controller.
BadgeRecipeStatic named label with secondary/accent appearances. No click, toggle, or automatic live announcement.
Button GroupRecipeConnected horizontal/vertical buttons, shared border, decorative separators, and optional static text. Existing Button actions, disabled states, and individual Tab stops are preserved; no roving selection model.
CardRecipeNamed region, level-two heading, description, header action, content, and footer slots. Layout and palette belong to the application; no card focus stop or state controller.
EmptyRecipeNamed static group with heading, description, optional media, and supplied actions. The command-search example clears the query and restores input focus through its existing state. No loading controller or automatic live announcement.
Input GroupRecipeShared frame for an existing InputBase, CommandInput, or other supplied control, leading/trailing addons, horizontal/vertical arrangement, and focus/error presentation. Native editing, Field metadata, addon actions, and disabled policy remain with the supplied controls and application. No separate editor or focus controller.
ItemRecipeNamed row with a title, description, leading media, full-width header/footer and supplied trailing action. Slots carry only the semantics of their content and add no focus stop. No whole-row activation, selection, ItemGroup or list controller.
KbdRecipeStatic named keycaps with readable-label overrides for symbols and +-joined combinations. No focus stop, shortcut registration, event dispatch, or automatic platform-glyph conversion.
PaginationRecipeControlled previous/next and numbered page Buttons, native current-page metadata, constant-width ellipsis runs, named navigation, and empty/first/last-page boundaries. No routing or data loading.
SheetRecipeTop/right/bottom/left presentation using the existing Dialog lifecycle, viewport-limited preferred size, fixed header/footer and one vertical ScrollArea body. The application retains DialogState/ScrollHandle and supplies header/footer content that fits the viewport. No drag interaction, animation or separate modal/scroll-key controller.
SkeletonRecipeStatic decorative placeholder with application-controlled width, height, rounding, and color. No focus stop, native role/name, shimmer, or loading state.
SpinnerRecipeNamed indeterminate Progress with a rotating arc, size/color styling, and GPUI App reduced-motion support. The application controls mounting; no independent task, timer, or automatic live announcement.
TableAvailableShared fixed/flexible columns, header/body/footer rows, caption and native table/row/cell semantics, with optional application-supplied row selection and header sort direction. No spans, sorting/filtering engine, selection controller or virtualization.
TypographyRecipeNamed Heading with an explicit positive level, Paragraph with native styled text runs for inline code, and independently named InlineCode with native Code semantics. Paragraph exposes one complete accessible name; its code ranges have visual styling without separate Code nodes. Palette, font choice, width, and visual size belong to the application. No Markdown parser, syntax highlighting, copy action, or editor.

Larger combined capabilities

These entries combine lower-level behavior and presentation into more complete workflows. They remain part of the breadth target, and should grow from working shared components rather than independent implementations of the same input, popup, focus, and scrolling machinery.

Catalogue entryStatusCurrent scope or gap
AttachmentRecipeStatic native Group named by its full filename, with a visible media-type/size description and optional existing actions. Help derives in-memory JSON metadata from the same string as CodeBlock; Inspect JSON focuses that code viewport. Formatting and action behavior belong to the application. No file access, upload/download, progress, preview renderer, or container focus stop.
BubbleRecipeIncoming/outgoing conversation surfaces, grouped author/time metadata and supplied reaction Buttons, demonstrated in the local transcript. Styling, reaction values and message content remain application-owned; no chat transport.
CalendarAvailableSingle/multiple/inclusive range selection, separate focus, six weeks with configurable first weekday, disabled-date predicate, bounded navigation, RTL and native multiselectable metadata. Unavailable in-bounds dates remain keyboard-discoverable but cannot be selected. No non-Gregorian arithmetic, clock or timezone conversion. Applications can jump directly to a month and year without changing selection.
CarouselAvailableOne or more consecutive slides per view stepping by one slide with a full last view, bounded or looping previous/next, horizontal/vertical keys, RTL, discrete pointer swipe, view-only mounting, safe focus when slides leave the view, and opt-in autoplay that pauses on hover, focus, inactive windows and reduced motion and stops on user navigation. App-owned media, slide widths, actions and the play/pause control; no inertia or free scrolling between snaps.
ChartAvailableHeadless categorical data, visible series and pointer/keyboard point inspection over grouped, stacked, pie and radar layouts; the layout owns the range, stack spans, slice shares and linear or angular hit testing. Copyable native line/bar/area, stacked bar/area, pie/donut and radar plots with axes or spoke labels, legend Toggles, exact-value readout and same-data Table. Negative values stack separately from zero; nonpositive pie totals have no slice. No time/log scales, per-slice legend selection or external chart engine. Applications supply plot and table labels, the category heading and value formatting, including units and fractional ticks.
Code BlockRecipeRead-only multiline code with a full-text native Code name, a Button that copies the original string, and bounded two-axis ScrollArea overflow. The application retains its scroll/focus handles. Focused-code arrow/page/Home/End navigation and contained wheel scrolling preserve parent boundaries. No parser, syntax highlighting, editor, selection model, line numbers, or copy-feedback state.
Data TableRecipeFixed columns, replaceable stable-ID rows, application-rendered cells, and text, number or date sort keys. Search, single-column sort, column visibility and surviving row selection persist across refreshes. Changing page size keeps the first visible row in view. The recipe also supplies an empty state, row actions, and native selection and sort metadata. Reordering, server requests and virtualization belong to the application.
Date PickerAvailableSingle/multiple/range Calendar values inside Popover; single/complete-range activation closes before events, partial/multiple values stay open. Preset Buttons use the same programmatic setter. parse_date_text reads typed ISO dates and English relative forms (today, in 3 days, 2 weeks ago) against an application-supplied today, as in the Schedule field. Trigger formatting and appearance are application-owned; other languages, free-form phrases and preset fetching are not supplied.
DrawerAvailableFour-edge modal surface using Dialog focus, Escape and backdrop dismissal. Drag its handle toward the edge to close. Vertical drawers can snap to configured fractions of the window height. Body scrolling and editing stay independent.
MarkerRecipeStatic date/status boundary with one named native Label between two decorative Separators. The text wraps within a bounded width; its content and formatting belong to the application. Schedule reads the retained Calendar selection without another date or timeline state. No focus stop, action, or automatic live announcement.
MessageRecipeRead-only native Comment with application-supplied author/time Labels, a wrapping Paragraph body, and an optional existing action. Schedule presents the retained session note and its local edit time, with a Button returning focus to the shared Textarea. No message focus stop, delivery state, transport, history, streaming, or automatic live announcement.
Message ScrollerAvailableExisting ScrollArea with stable message keys, initial/append/stream bottom following, same-frame preservation of a visible history anchor, unread count and jump-to-latest. No virtualization, transport or forced focus changes.
QuestionnaireAvailableTyped application-owned answers with a linear question/review/complete state, validation-gated advance, Back and retained answers. The example connects real Input editors and app-owned focus changes; no schema interpreter or conditional branching.
SidebarRecipeNamed navigation with ordinary Buttons, explicit activation and current-page metadata over dedicated TabsState; static groups and optional whole/group Collapsible state preserve selection and restore focus when entries unmount; an optional icon rail keeps named, current, focused entries mounted as icon-only Buttons with hover tooltips. Below 640 px, Settings stacks its navigation above the content and the Projects catalogue offers a navigation Sheet. No routing, arbitrary nested menu tree or reuse of a state previously bound by TabList.
TraceRecipeApplication-supplied summary, named read-only Paragraph details, and an optional existing action over retained Collapsible state. Shared Button activation, expanded/disabled metadata, active-only content, and focus on closure are preserved. Help presents current form values rather than recorded operations. No execution history, streaming, parser, separate disclosure state, or scroll controller.

Completion criteria and current work

The target is shadcn/ui-level usability across behavior, accessibility, visual defaults, and source distribution on native GPUI. The 66-entry catalogue counts scope coverage only. It is not a completion percentage or a release-readiness claim. Available, Recipe, and Mapped above do not mean parity is complete.

Work is tracked here and in Git, without a separate progress report. A capability is complete when its documented consumer contract is implemented, exercised in a native example, covered at the appropriate existing test layer, and accurately documented. Platform observations are recorded separately from automated checks.

PriorityWorkExit conditionCurrent state
1Existing correctness and core interaction gapsFix observed failures; support single-selection ToggleGroup and multiple-open Accordion; verify native values, keyboard/pointer activation, disabled state, and focus on closureImplemented with focused tests and catalogue consumers
2Remaining common component contractsAudit the official component examples against each scope above; implement manual Tabs activation, popup side/alignment, range inputs/date selection, and the remaining consumer-required selection/table/navigation capabilities with focused tests and examplesListed common gaps implemented; core retained-value, composition, source-distribution and native-metadata audits completed. Feature limits remain explicit in the scope table
3Visual defaults and accessibilityConsistent visible keyboard focus, disabled/hover/selected/error states, reusable application-owned tokens, narrow-window layout, and usable light/dark presentationsCatalogue focus and copyable light/dark tokens implemented; native Calendar/Sheet smoke performed; unnamed catalogue buttons/links corrected with regression coverage; wider native review pending
4Source distribution and developer experienceA small complete starter, compilable public examples, explicit supported API boundary, and a source-copy workflow that resolves recipe dependencies and tokensStarter, doctest gate, application tokens and dependency-aware source CLI implemented; supported input/control boundary and consumer test feature documented; unused ThemeAppearance removed
5Release validationExisting formatting, lint, full behavior suite and native example builds pass; representative native IME, screen-reader, DPI, and visual flows have platform-specific observationsNot complete

The Verify workflow records Rust checks and native example builds for each revision. The Docs workflow checks the installation snippet's GPUI pins, builds the WebAssembly previews and runs the site's browser tests.

The "not supplied" limits that shadcn's official examples cover are now implemented within explicit boundaries: typed dates accept ISO and a few English relative forms rather than arbitrary natural language, and layout storage stays with the application. Touch long press is exercised with simulated GPUI touch events only; it has not been tried on touch hardware. Carousel autoplay, the Sidebar rail, ControlField and AvatarGroup have headless and composition coverage only; their native appearance has not been observed.

Existing tests cover the documented selection/overlay contracts, retained-value setters, unavailable Calendar days/RTL, table selection/visibility, Sidebar closure, native read-only metadata, multiline/scrolled UTF-16 point lookup and modal flags (including non-modal Popover), plus background pointer/wheel isolation without a decorative backdrop. Composition checks include Sidebar at 320/980 px and all Sheet edges at 320×520/980×840.

Native Windows observations cover starter editing/Tab/Enter, the Selection view and range popup, unavailable Sunday focus/blocked activation, and top Sheet layout/body scrolling/focus return. UI Automation names were inspected, corrected where absent, and re-observed in Navigation/Selection. These are limited visual and metadata observations, not screen-reader speech verification.

A later native Windows pass (one QHD monitor, assumed 100% scaling, light and dark presentations) observed the catalogue's line, stacked bar/area, pie, donut and radar charts, radar pointer inspection, the Carousel at one and two slides per view with Next, and the Breadcrumb ellipsis menu navigating to Component APIs. In two_styles it observed the Item media/header/footer layout, the rich Edit session tooltip, typed dates ("in 3 days" applied; "2026-02-30" showed the Field error), and the schedule divider stopping at the plan pane's about-96 px floor. That pass moved radar spoke labels clear of the rim and replaced a font-dependent record glyph in Item media with a drawn dot.

Still open: actual Korean/CJK IME composition/candidates/commit/cancel, screen-reader speech and actions, mixed DPI, touch hardware, and the remaining desktop visual review. The automation tool does not support the Hangul key, so that native flow needs manual Korean mode selection. Headless handler tests do not establish native IME behavior. The overall goal remains incomplete. The official Accordion multiple example, Toggle Group usage, Slider range, Calendar, and Combobox provide concrete behavior references. The Data Table guide and Sidebar supply the selection, column visibility and collapse/group composition references. The Sheet reference describes four-edge placement. Calendar's unavailable-date focus follows the APG disabled-grid guidance; its application predicate and week order remain explicit native contracts. The introduction and theming guide also make visual defaults and source reuse part of the target. Browser-specific APIs require an explicit native equivalent rather than an extra alias.

Hands-on checks on Windows

Run the example you need from PowerShell at the repository root. Close its window before starting the next example.

cargo run -p gpui-deck --example starter --locked
cargo run -p gpui-deck --example catalogue --locked
cargo run -p gpui-deck --example two_styles --locked -- settings

Alongside Navigation, catalogue includes OTP, Drawer, Toast, media, charts, conversation and questionnaire examples.

CheckWhat to doWhat to expect
Hangul composition and font · starterSelect the Korean IME’s 가 mode on the taskbar. Type 한글 into Your name, switch to English input, append a space and ABC 123, then press Say hello.Characters stay visible and appear once as the syllables form. The result reads Hello, 한글 ABC 123!. Both the field and the result show complete characters without clipping or missing-glyph boxes.
IME candidates · starterClear the field, type 한 in 가 mode and press the Hanja key to open the candidates. Cancel with Esc, reopen the list and choose one candidate. On some layouts, right Ctrl serves as the Hanja key.The candidate window opens near the caret. Canceling leaves 한 in the field. Choosing a candidate replaces it with the selected character and leaves Say hello untriggered. Microsoft’s Korean IME guide
Screen reader and keyboard · catalogueOn the Navigation tab, narrow the window until the Project sections button appears. Start Windows Narrator, return to the app and Tab to the button. Open it with Enter, close it with Esc, then reopen it. Tab to Members and press Enter.You can identify the button and the item by their spoken names. Esc returns focus to the same button. Selecting Members closes the panel and shows Members in the main content. Use Win+Ctrl+Enter to start or stop Narrator. Microsoft’s Narrator guide
Mixed display scaling · two_stylesMove the same window between two monitors with different scales, such as 100% and 150%. On each monitor, open Session actions on the first screen and click Show cursor. Repeat the Hanja candidate check in starter on both monitors.The menu opens near its button and the candidate window near the caret. Text and borders are fully visible. Clicking the item switches the status between Cursor visible and Cursor hidden.
Touch · two_stylesOn a touchscreen, press and hold the summary area labeled Session actions: right-click or beside the Shift and F10 keycaps. Lift your finger, then tap Show cursor.One menu stays open near the point you touched after you lift your finger. Tapping the item changes the status once and closes the menu.

Record the IME, screen reader, display scales and what you saw or heard. Mark a check as untested if you lack the second monitor or touchscreen it requires. Record browser previews and automated checks separately from native observations. Report performance only when measured.

Reference distinctions

The shadcn introduction describes source ownership, composition, distribution, and visual defaults. Comparable breadth includes those consumer-facing recipes as well as headless behavior.

The current Combobox documentation covers an editable autocomplete and additional selection variants; the implementation here supplies grouped single/multiple selection and item replacement. Applications retain chip presentation and asynchronous request ownership; these capabilities deepen the same family rather than add components. Command includes a dialog composition rather than requiring a second independent command engine.

Date Picker is composed from calendar and popup parts. Data Table is a guide to building application-specific tables over shared foundations. Native Select explicitly wraps a browser HTML control, so its platform contract requires adaptation.