GPUI Box GitHub

Components

A builder is RenderOnce: construct and mount it in one expression. A view survives a frame, so it is held in an Entity. Both report an intent and apply nothing.

agent

The AgentActivityLine component in agent-avatar AgentActivityLinebuilder

The localized execution sentence and its non-colour status mark.

The AgentAvatar component in agent-avatar AgentAvatarbuilder

A status-coloured agent identity with a separate presence mark.

The AgentCard component in agent-roster AgentCardbuilder

A complete summary of one agent and its current caller-owned task.

The AgentGroup component in agent-roster AgentGroupbuilder

A compact overlapping group of agent identities with an overflow count.

The AgentPlan component in agent-plan AgentPlanbuilder

A plan, as a run of marks and one line about the item in flight.

The AgentRoster component in agent-roster AgentRosterbuilder

A virtualized list of agents with standard identity and activity rows.

The AgentRunCanvas component in agent-run-canvas AgentRunCanvasbuilder

A typed, read-mostly view of an AgentRunSnapshot on a node canvas.

The AgentRunIssues component in agent-run-issues AgentRunIssuesbuilder

A single truthful notice for malformed multi-agent snapshot structure.

The ApprovalPrompt component in approval ApprovalPromptview

One request for permission, with the answer left to the caller.

The ArtifactPreview component in artifact-preview ArtifactPreviewbuilder

A titled pane for a generated artifact.

The ClarificationPanel component in clarification ClarificationPanelview

One clarifying question, with the answer left to the caller.

The ContextGauge component in cost-meter ContextGaugebuilder

How much of a context window a run has used.

The CostMeter component in cost-meter CostMeterbuilder

What a run has cost so far, line by line.

The FeedbackRating component in feedback-rating FeedbackRatingbuilder

A helpful / not-helpful control with optional host-owned reason tags.

The OfferingCatalog component in offering-catalog OfferingCatalogbuilder

A searchable, kind-filterable catalog of offerings from multiple servers.

The PermissionMatrix component in permission-matrix PermissionMatrixbuilder

A grid of subjects against actions.

The PersonaDialogue component in persona PersonaDialoguebuilder

Persona-aware dialogue over the safe Markdown renderer.

The PersonaPortrait component in persona PersonaPortraitbuilder

A large expressive portrait built on the standard AgentAvatar.

The PromptBuilder component in prompt-builder PromptBuilderbuilder

A template with host-owned slots.

The ServerList component in server-list ServerListbuilder

The connections an application holds, and what each one offers.

The SubagentTree component in agent-roster SubagentTreebuilder

A caller-controlled hierarchy derived from Spawn links in a run.

The ThinkingBlock component in thinking ThinkingBlockbuilder

A collapsed block of model reasoning.

The ToolCall component in tool-call ToolCallbuilder

One quiet evidence row for a tool invocation.

The VoiceReactive component in persona VoiceReactivebuilder

A standard voice-reactive visualization from a normalized host sample.

canvas

content

controls

The Button component in button Buttonbuilder

A labeled action.

The ButtonGroup component in actions ButtonGroupbuilder

Adjacent related actions sharing one frame.

The Cascader component in cascader Cascaderview

A menu of progressively revealed caller-owned option columns.

The Checkbox component in choice Checkboxbuilder

A box that reports one of on, off, or partly on.

The ColorPicker component in color-picker ColorPickerbuilder

Hue, saturation-brightness, optional opacity, and host-owned swatches.

The ColorSwatch component in color-picker ColorSwatchbuilder

A clickable colour chip. Reports the colour it was given; applies nothing.

The Combobox component in touch-pickers Comboboxview

A Select you can type into.

The CopyButton component in copy-button CopyButtonview

A button that copies caller-supplied text and confirms what happened.

The Dropzone component in dropzone Dropzonebuilder

An area that accepts a drop.

The Editor component in editor Editorview

Plain source editing with caller-owned language policy.

The FilterBar component in filter-bar FilterBarbuilder

A row of active conditions, a way to add one, a clear-all, and the count.

The FindReplace component in find-replace FindReplaceview

A SearchField with a replacement field and the two replace actions.

The FormField component in form FormFieldbuilder

A labelled control, with the secondary text a typist needs around it.

The IconButton component in actions IconButtonbuilder

An action carried by a glyph alone.

The InlineEdit component in inline-edit InlineEditbuilder

Text that a click or enter turns into a field.

The KeybindingRecorder component in keybinding KeybindingRecorderview

A field that records one keystroke.

The KeymapEditor component in keymap-editor KeymapEditorview

Coordinates one recorder over caller-owned keymap rows; it never applies a binding.

The MentionInput component in mention-input MentionInputview

A multiline editor with one caret-anchored mention completion surface.

The MultiSelect component in multi-select MultiSelectview

A selectable option set with search, chips, and listbox semantics.

The NumberInput component in form NumberInputview

A number field with a step grid and, optionally, a range.

The OneTimeCodeInput component in touch-inputs OneTimeCodeInputview

One sensitive editor presented as a bounded run of visual slots.

The PasswordInput component in touch-inputs PasswordInputview

One sensitive password editor with a visual reveal action.

The Radio component in choice Radiobuilder

One option in a set where exactly one can hold.

The RichTextEditor component in editor-options RichTextEditorview

The visible projection over a caller-owned rich-text editing session.

The SearchField component in search-field SearchFieldview

A query field, a hit count, and next and previous.

The SearchInput component in search-input SearchInputview

An in-content query with a magnifier and a clear action when nonempty.

The SegmentedControl component in form SegmentedControlbuilder

A strip where exactly one segment holds.

The Select component in input Selectview

A closed list of options with one answer.

The SettingsList component in settings SettingsListbuilder

Settings sections filtered by one caller-owned query.

The SettingsRow component in settings SettingsRowbuilder

One setting: what it is called on the left, what it is set to on the right.

The SettingsSection component in settings SettingsSectionbuilder

A headed group of settings rows.

The Slider component in choice Sliderbuilder

A track with one or two handles.

The SplitButton component in actions SplitButtonview

One action, plus the ones it stands in for.

The Switch component in choice Switchbuilder

A control that takes effect the moment it is flipped.

The TagInput component in form TagInputview

A field that collects a set of short tokens.

The TextArea component in touch-inputs TextAreaview

Wrapped, multi-line editable text.

The TextInput component in input TextInputview

One line of editable text.

The Toggle component in toggle Togglebuilder

A button that stays in.

The ToggleGroup component in toggle ToggleGroupbuilder

A run of toggles where none, one, or several may be in.

The TransferList component in transfer-list TransferListview

A controlled source/target assignment control.

The UploadList component in upload-list UploadListbuilder

A list of files being uploaded, optionally over the zone that took them.

data

datetime

display

The AnimatedNumber component in animated-number AnimatedNumberbuilder

A numeric readout that animates between values.

The AreaChart component in chart AreaChartbuilder

A filled area chart over one or more host-owned series.

The AttachmentTile component in attachment AttachmentTilebuilder

A standalone attachment tile, separate from message-list attachment metadata. All four slots compose native elements: media, title, description, and actions. A supplied preview remains visible on failure because already-known media is not erased by a failed transfer or refresh.

The Avatar component in avatar Avatarbuilder

A circular mark for a person or a workspace.

The AvatarGroup component in avatar AvatarGroupbuilder

Several identities in one place, overlapping, with the rest counted.

The Badge component in badge Badgebuilder

A compact status label.

The Banner component in banner Bannerbuilder

A page-level tinted report: title, action, and a way to close it.

The BarChart component in chart BarChartbuilder

A bar chart over one host-owned series of categorized values.

The BarLoader component in loading BarLoaderbuilder

A thin working strip for the edge of a region that is filling in.

The Bubble component in bubble Bubblebuilder

A token-backed message surface with caller-owned content.

The Callout component in status Calloutbuilder

A tinted message block.

The CandlestickChart component in plot CandlestickChartbuilder

Candlesticks over caller-owned normalized OHLC readings.

The Card component in card Cardbuilder

A raised panel that groups related rows or content.

The CartesianChart component in cartesian CartesianChartbuilder

Shared-coordinate line/area/bar/scatter layers over raw f64 observations. Missing samples break paths. All-zero data is ready, not empty. An invalid dataset is an explicit error. Stale data remains visible with its reason.

The ChartLegend component in chart ChartLegendbuilder

A standalone legend that reports series hide and show.

The ContinuousHeatmap component in continuous-heatmap-transition ContinuousHeatmapbuilder

A raw-valued matrix with visible cell values and a numeric color legend. Selection is caller controlled. Invalid coordinates, identities, and readings produce an explicit error; a stale refresh retains verified cells and reason.

The DescriptionList component in detail DescriptionListbuilder

A list of term and description pairs, in one or two columns.

The Divider component in divider Dividerbuilder

A soft rule between groups.

The EmptyState component in empty-state EmptyStatebuilder

A centred explanation with an optional action.

The FailurePanel component in failure-panel FailurePanelbuilder

A panel that states what went wrong instead of what it was going to show.

The GaugeChart component in chart GaugeChartbuilder

A single already-normalized reading on a semicircle.

The GeoMap component in geography GeoMapbuilder

A controlled local map with choropleth legend, selectable feature readout, and point overlays. Click selects projected geometry; captured drag/touch pans and pinch/Ctrl-wheel zooms about the pointer. Arrow keys pan, +/- zoom, Home resets, F fits, / cycle selection. Escape cancels a drag or clears selection. No handler means a read-only map.

The Heatmap component in heatmap Heatmapbuilder

A labelled grid of intensity cells.

The HighlightedText component in search-field HighlightedTextbuilder

A run of text with some of it marked.

The Icon component in icon Iconbuilder

A glyph from the bundled catalog.

The LineChart component in chart LineChartbuilder

A line chart over one or more host-owned series.

The ListRow component in card ListRowbuilder

One row inside a Card.

The LoadMore component in loading LoadMorebuilder

The tail row of an incrementally loaded list.

The MetricCard component in metric-card MetricCardbuilder

A compact KPI card.

The OutcomePanel component in outcome-panel OutcomePanelbuilder

A panel that states what finished, including a partial success.

The PerformanceHud component in performance-hud PerformanceHudbuilder

A compact or expanded frame diagnostics surface.

The PieChart component in chart PieChartbuilder

A pie or donut over one host-owned series of shares.

The Plot component in plot Plotbuilder

A measured plot with caller-painted content and semantic marks.

The ProgressBar component in progress-bar ProgressBarbuilder

A horizontal bar for work whose extent is known.

The ProgressCircle component in progress-circle ProgressCirclebuilder

A ring for work in a place too tight for a bar.

The PulseLoader component in loading PulseLoaderbuilder

A row of breathing dots, used while a request is in flight.

The RadarChart component in chart RadarChartbuilder

A polar reading over host-owned axes.

The Rating component in rating Ratingbuilder

A controlled scalar rating rendered as token-sized stars.

The RefreshVeil component in loading RefreshVeilbuilder

A veil over content that is still the last verified value.

The SankeyChart component in plot SankeyChartbuilder

Sankey ribbons over caller-owned normalized layout.

The ScatterChart component in chart ScatterChartbuilder

Scatter or bubble marks over one or more host-owned series.

The Skeleton component in loading Skeletonbuilder

Placeholder rows shown while a list's real shape is unknown.

The SpanTimeline component in trace SpanTimelinebuilder

The waterfall alone: bars and a time axis, with each span named at its own bar instead of in a gutter.

The Sparkline component in sparkline Sparklinebuilder

A compact, accessible trend reading.

The SpecializedChart component in specialized SpecializedChartbuilder

Specialized raw-value presentations with a persistent labeled value key, keyboard selection, semantic marks, and retained-data refresh failures.

The Spinner component in loading Spinnerbuilder

An inline turn, for a wait that sits next to a label.

The StackedBarChart component in chart StackedBarChartbuilder

Bars stacked from the same category identity across series.

The StageProgress component in stage-progress StageProgressbuilder

A run of named stages, all of them supplied by the caller.

The StaleMark component in state-ladder StaleMarkbuilder

The mark that a verified value is still on screen after a failed refresh.

The StateView component in state-ladder StateViewbuilder

A region that picks the truthful waiting, empty, failed, or ready surface.

The StatusDot component in status StatusDotbuilder

A tone-colored dot, the smallest state indicator in the system.

The StatusLine component in status StatusLinebuilder

A dot plus a short label, for inline state.

The Tag component in tag Tagbuilder

A label with an optional remove action.

The Timeline component in detail Timelinebuilder

A chronological feed, optionally divided into days.

The TraceView component in trace TraceViewbuilder

Hierarchical labels beside a waterfall of caller-owned spans.

effects

game

interaction

layout

media

navigation

overlay

structured

motion