Primitives

GPUI Base primitives provide behavior without prescribing presentation. Each page documents the public import and the smallest useful composition. The live example above the page is built from crates/base/examples and can also run as a native GPUI application.

#Primitive catalog

Accordion — A disclosure group composed from independently styleable header, trigger, and panel parts.
Alert Dialog — A modal confirmation surface for actions that need an explicit decision.
Avatar — An image with composable fallback content for a person or entity.
Button — An unstyled, accessible pressable with semantic state and keyboard activation.
Calendar — A state-driven date grid with selection matchers and custom item rendering.
Checkbox — A controlled tri-state check control with a separately styled indicator.
Collapsible — A composable region that shows or hides content without prescribing its trigger styling.
Color Picker — State and interaction foundations for selecting colors in a custom picker UI.
Combobox — A text input paired with keyboard-navigable suggestions and selection behavior.
Date Picker — A focus-aware date input that composes calendar behavior with a popup.
Dialog — A composable modal surface with focus management, backdrop, title, and close parts.
Hover Card — A delayed floating card associated with a pointer or keyboard trigger.
Input — A single-line text input with selection, masking, validation, and number stepping.
Textarea — A multi-line text field with fixed rows, wrapping, and auto-grow behavior.
Editor — A source-code editor foundation with highlighting, gutter, folding, decorations, and LSP hooks.
Link — An accessible link-like control with application-defined styling.
Nav Stack — A navigation stack of views with push, pop, forward, and replace, and an animatable transition lifecycle.
Number Input — A numeric input with reusable increment, decrement, and step behavior.
OTP Input — A multi-cell one-time-code input driven by a shared text state.
Pagination — A controlled page navigator with explicit current and total page state.
Popover — An anchored floating surface with controlled or internally managed open state.
Popup — A low-level trigger and anchored floating-content host.
Progress — Composable track and indicator parts for reporting task completion.
Radio — A controlled single-choice item with selectable and disabled semantics.
Radio Group — Groups radio items and provides keyboard navigation for a single selection.
Resizable — Panel groups and resize handles for user-adjustable split layouts.
Scrollbar — An unstyled scrollbar connected to GPUI scroll or uniform-list handles.
Select — A button-like selection control backed by an anchored, keyboard-navigable popup.
Sheet — A modal surface that enters from an edge while managing dismissal and focus.
Slider — A state-driven range input with independently styleable track, indicator, and thumb.
Switch — A controlled on/off control with separately styleable track and thumb.
Table — Semantic table primitives for composing headers, bodies, rows, and cells.
Tabs — A tab list and accessible tab controls with controlled selection.
Toast — A managed, animated stack of temporary status messages.
Toggle — A controlled two-state pressable for persistent choices such as formatting.
Toggle Group — Coordinates a set of toggle controls as a single- or multiple-selection group.
Tooltip — A delayed, positioned description associated with a trigger element.
Tree — A virtualized hierarchical list with explicit expansion and selection state.