Reference
Changelog
Every release, newest first. Installed source never updates itself, so read the entry for a release before you overwrite files with it.
Notable changes to gpuicn. Detailed notes for each release are in
docs/releases. Installed source never updates itself; run
gpuicn diff after upgrading to see what a release changes in your copy.
0.13.4
Fixed
- Alert Dialog: Escape cancels it. A press outside still does nothing.
- Tabs: a context menu opened from
on_secondary_clickkeeps focus, so it takes Escape, the arrows and Enter.
0.13.3
Fixed
- Virtual List and Commit Graph: appending a page to a long list no longer stalls a frame when the list grows past a power of two. Rows and the ID index are stored in fixed-size chunks, so nothing already loaded is copied or rehashed, and a replaced long list is freed on another thread.
0.13.2
Fixed
- Dialog: a popup can be wider than 384 px. The host no longer caps the
width, so
dialog_popup(..).max_w(..)widens a sheet, and the command palette reaches the 480 px it asks for.
0.13.1
Added
- Diff:
hunk_action, a gutter button beside each hunk that reports the hunk's range, andheader_visible, which hides the file headers.
0.13.0
Changed
- Runtime pins move to GPUI Kit 0.10.0, still on
gpui-pre0.3.12 with gpui-icons 0.7.0. No gpuicn API changes; move thegpui-kitpin with gpuicn (gpuicn update --to 0.13.0). - The theme sets GPUI Kit's new
list_highlight_foreground(query matches in Select, Combobox and Command) toprimary.
Fixed
- Tabs: the arrow keys select the next tab again. GPUI Kit 0.10's tab list moves focus without selecting, which took over gpuicn's keyboard handling.
0.12.1
Added
- Virtual List:
append_items, which adds rows after the last one without rebuilding the list. - Commit graph:
append_rows, for the next page of history in time proportional to the page. - Tree:
expand_folders, which opens many folders with one rebuild.
0.12.0
Added
- Tree: a virtualized hierarchy with disclosure, typeahead, single or multiple selection, and lazily loaded children.
- Diff: GPUI Kit's patch viewer with Nova defaults, actions on selected lines and file-header actions, and a read-only mode.
- Commit graph: a history list that paints a caller-computed lane graph per visible row, with ref labels, shape-coded nodes and a theme-derived lane palette.
0.11.11
Added
text::INK,text::line_heightandtext::controlin the theme primitives: a line height that always fits the glyphs, and a text size that comes with one.
Fixed
- Truncated labels in buttons, menus, tabs, toolbars, collapsible triggers,
items, badges, key caps and tags no longer lose the bottoms of g, p and y.
GPUI Kit's base controls shrink the line box to the font size, which
truncate()clipped the descenders to. - Dialog titles get a 24px line box instead of 16px.
0.11.10
Added
AnchoredTooltip::anchored_tooltip, a hover tooltip centered above its element with an arrow, flipping below when there is no room above.
Changed
- gpuicn's own tooltips use
anchored_tooltipinstead of GPUI's native.tooltip(...), which opened below and to the right of the pointer. - Menu rows with a description have room for both lines; separators have more space around them.
0.11.9
Added
item::Reveal, for row actions that show while their row is hovered or keyboard focus is inside it. Hidden actions stay focusable and visible to screen readers; tabbing onto one shows it.
0.11.8
Changed
LinkPreviewis laid out as Mattermost's webapp: the collapse toggle is a round chevron over the large image's top-left corner, not a row of its own above the title; a hidden image leaves "Show image preview" in its place; large images keep their own size up to 392 × 240; the card fills its container up to 700px; the title takes one line and the description two. Images narrower than 4:3 show as thumbnails, which have no toggle.- The toggle's names are "Hide image preview" and "Show image preview".
0.11.7
Added
Tab::trailing,Tab::aria_labelandTab::on_secondary_click, for tabs with a count badge and a context menu.Tabs::end,Tabs::size(TabsSize::Sm)andTabs::text_colors, for tab rows in a sidebar with a "More" menu at the end.
0.11.6
Fixed
- A message header's name, time and
header_childmarkers line up: the row centres its items, since GPUI reports no text baselines. Embed headers too.
Changed
- Registry items carry a
metawithsinceand the catalog group. loop_phasesteps on the executor's clock.
0.11.5
Added
ButtonVariant::SidebarandToggleVariant::Sidebar, for controls on a sidebar that is darker or lighter than the page.ToggleGroup::segmented, a segmented control with the pressed option raised.TitleBar::page, for a window with no sidebar under the bar.
Changed
- The reacted count,
Linkbutton, collapsible trigger and embed toggle draw their text inlink(), notprimary. TitleBardraws its content and window controls in the sidebar's colors.- The color picker's hue track is vivid whatever color is picked.
0.11.4
Added
Message::footer, a line under the reactions for a thread's reply summary.
Changed
- A press on blank space in a message row no longer starts a text selection.
EntityLinksdraws unmatched entities as plain links; only matches get a chip.LinkPreviewleaves out an empty site name and colors its title as a link.
0.11.3
Added
HoverPopover::suppress_hover_when, so a hover preview does not open while a menu is open or something is being dragged.
0.11.2
Added
HoverPopover::passiveandHoverPopover::open_requested, for a preview on a row that keeps its own click and focus.
0.11.1
Added
title_bar::window_drag_area,WindowControls,draws_window_controlsandtraffic_light_inset, for windows without a title bar.Sidebar::track_scroll,Sidebar::overlay,Sidebar::header_paddingandSidebar::footer_padding.
0.11.0
Changed
- Runtime pins move to GPUI Kit 0.9.1 on
gpui-pre0.3.12 and gpui-icons 0.7.0. No gpuicn API changes.
0.10.6
Changed
Messageshows its add-reaction button only while the row is hovered or selected (rows with an action bar), and reaction chips build no id strings per frame.
0.10.5
Changed
SpinnerandSkeletonstep 12 times a second on a shared clock instead of redrawing every frame, and pause while their window is in the background.
Added
theme::loop_phaseandLOOP_STEPS_PER_SECONDfor other looping indicators.
0.10.4
Changed
- Markdown tables are as wide as their content, with a bold header and a rule around every cell.
- Headings have a smaller gap above them; quotes keep full-strength text; code blocks are slimmer.
Added
MarkdownBlocksandmarkdown_with, to render table cells and headings with the application's Markdown view.
0.10.3
Fixed
- Controls claim their press: pressing one never starts a text selection,
and a clickable
Messagerow leaves the click to it. - Tooltips use the popover surface, so they follow light and dark mode.
- A selected
SidebarItemkeeps its colors on hover.
Added
message::emoji_tooltip,SidebarItem::label_suffix_tooltip_viewandprimitives::press.
0.10.2
Added
Sidebar::surfaceandSidebarItem::surfacedraw a navigation on the page's muted surface instead of the sidebar colors.
0.10.1
Added
- Rich
MenuItems:.icon,.leading,.description,.trailingand.shortcut, plusMenuState::width(#174). Item,ItemGroupandItemSeparator, ported from shadcn/ui (#175).
0.10.0
Changed (breaking)
- One-value handlers take the value by reference, the shape
cx.listenerreturns (#168).Checkbox,SwitchandToggleon_changetake&boolwith noClickEvent;TabsandRadioGrouptake&SharedString;CheckboxGroupandToggleGrouptake&[SharedString];Calendar::on_selecttakes&CalendarDate;MessageList::on_selecttakes&Option<usize>.
0.9.13
Added
dialog_withandalert_dialog_with: build a dialog's popup only while it is open (#164).
Fixed
- Show more appears inside cached views (#161); several components repaint only their own view instead of the whole window (#163).
- Calendar and Resizable take Escape ahead of an app's Escape shortcut (#165).
- "N new messages" is translatable (#166); releases retry Apple's stapler (#162).
0.9.12
Added
color_picker: hue, chroma and lightness sliders in OKLCH, plus optional swatches (matty#705).Slider::gradient, for color sliders.
0.9.11
Added
Message::on_click, for opening a row's thread (matty#680).message::reaction_tooltipwith the emoji large, andmessage_emoji_actionfor one-click reactions (matty#679).
Changed
- A chip's plain tooltip text uses the new reaction tooltip.
0.9.10
Added
Message::actions_with, building the hover action bar only when it shows (matty#674).
Changed
Messagelays out its action bar only for the hovered or selected row.
0.9.9
Fixed
- Sized
Attachmentimages shrink with a narrow column (matty#683). ShowMore's chevron is visible.
0.9.8
Added
SidebarItem::label_suffixandlabel_suffix_tooltip, for a status emoji right after a row's name (matty#681).- A copy button on every Markdown code block, and
collapsible::ShowMorefor long content (matty#682). LightboxImage::dimensions, so small images keep their natural size (matty#676).primitives::dismiss::on_escape, theDismissaction andDISMISS_CONTEXT.
Fixed
- Escape closes dialogs, popovers, menus and the lightbox even when the app binds Escape around them (matty#676).
- The lightbox closes on a click around the image (matty#676).
0.9.7
Added
- Replaceable built-in strings: every word a component writes, from
"Close" and "Search emoji" to month names and accessible labels, is a
UiTextwith an English default thatlocale::set_stringstranslates (#143). - Right-to-left layouts:
locale::set_direction(cx, Direction::Rtl)mirrors rows, paddings, chevrons, drawers, popovers, menus and toasts, aligns inputs to the start and makes Left and Right follow the reading direction (#143). locale::isolatefor names inside mixed-script text, andDirectionalStyledstart/end helpers for your own views (#143).- Sortable
wrap(false)andgap(px)for one-line horizontal bars (#145). - OtpField pastes a code: Cmd/Ctrl+V and the Edit menu's Paste fill the cells from the clipboard's digits (#147).
- Animated GIFs play in attachments, avatars, custom emoji, Markdown
pictures and the lightbox, through the new
primitives::image(#149).
Fixed
- A menu item's
on_clickcan rebuild its menu withset_itemsinstead of panicking (#148).
0.9.6
Added
- Alert, Avatar Group, Calendar, Date Picker and Date Time Picker components (#135, #138, #140).
- Avatar status dots scale with resized avatars (#127). Button
tint(#134). Command item descriptions (#133). - Composer: triggers ignored in code (#129), app-chosen suggestion ranges (#136) and misspelling underlines (#139).
- Field takes checkboxes and radio groups; focused inputs get an opaque fill (#135). Textarea misspellings with a suggestions menu (#139).
- MarkdownImages placeholders and known sizes (#131). Message copy prefixes for multi-message copy (#128). MessageEmbed actions (#134).
- Select
set_itemsandset_loadingfor async results (#141). Horizontal Sortable (#137). - Theme: link, mention, new-messages and sidebar badge tokens, code block
themes and
UiTheme::opaque(#132).
0.9.5
Added
- Message:
on_author_clickmakes the name a focusable, link-styled button whose handler gets the name's bounds, andauthor_elementreplaces the name with any element, such as a popover trigger (#123). - Toast:
Notice::on_dismissreports why a notice left (NoticeDismissal),ToastState::contains(id)says whether one is still showing, andset_placement/set_insetmove the stack (#122).
0.9.4
Added
- Avatar:
status(AvatarStatus)draws a presence dot (Online, Away, Dnd, a hollow Offline ring, orCustom) with aring_colorsurface ring, and adds the status to the accessible name (#115). - Popover:
hover_popover, a popover that opens on hover without taking focus, and on click, Enter or Space with focus moving into it, for profile cards (#118). - Embed:
QuotedMessage, a quoted-post card for permalinks and forwards (#119). - Sortable: a new component whose rows drag to reorder and move between
groups, with Alt+Shift+Up and Down and an announcement; groups reorder too
with
reorder_groups(#121). - A
test-supportcrate feature withgpuicn::audit:unnamed_controlslists interactive elements without an accessible name, andA11yAuditOverlayoutlines them in a debug build (#120).
Changed
- Menu panels use the room in the window before they scroll, instead of stopping at 288px, and submenus open after resting the pointer on their row for 200ms (#117).
- Command and composer options, emoji picker cells and tabs, the OTP field, Slider, the Resizable handle, Virtual List and context-menu areas register for GPUI Kit's element queries with their role and name (#120).
0.9.3
Added
- Embed:
ImagePlaceholder, a click-to-load placeholder for remote images, throughLinkPreview::image_placeholder,MessageEmbed::image_placeholderandMessageEmbed::thumbnail_placeholder(#111).
0.9.2
Added
- Embed:
LinkPreview(Open Graph previews with collapse and remove) andMessageEmbed(integration attachments with a colored bar, fields and a footer) for cards under a chat message (#108).
Fixed
- A dialog taller than the window scrolls with the wheel over its surface:
dialog_popupnow blocks the mouse except scrolling, so the wheel reachesmodal_viewport(#109).
0.9.1
Added
- Message
timestamp_tooltipandon_gutter_click. - Toast
Notice::actionandNotice::cancel. - MessageList
on_jumpandshow_jump. - Attachment
dimensionsandmax_sizefor image thumbnails. - Sidebar
roving_focus: one tab stop with arrow-key navigation. - Composer
max_height,ComposerState::set_max_rowsandmax_rows. - ScrollArea
track_scroll.
0.9.0
Added
app::runandAppConfig: one-call application start with icons, fonts, a theme pair and the first window.Appearance,UiTheme::set_pair,UiTheme::set_appearanceandtheme::follow_system.- CLI: shadcn base colors,
init --base-color/--radius/--appearance/--theme/--all,theme set|import|preview,update,doctor,remove --unused; config version 2 with a[theme]table. theme::primitives(text, icon, focus, disabled, surface, control, clipped_image, dismiss, hover_reveal_in_group), status colors, typography and breakpoint tokens,transition_with,presence_with,UiEasing::Emphasized.MessageListScrollbarandMessageList::scrollbar_handle.MessageDensity::Compactfor Message.cargo xtask new-component,docs/design.md, the registry lint and the catalog screenshot sheet in every release.
Changed
- Every component reads colors, sizes, radii, shadows and motion from the theme through the primitives; focus is one 3px outer ring everywhere.
- Input and Textarea share
InputCore; dialogs fade in and let the host viewport scroll. - Toast uses deadlines instead of a 50ms poll; one Escape interceptor serves every tooltip.
UiTheme::shadowsentries areArc<[BoxShadow]>;sidebar_is_mobiletakes the window.
Fixed
- The MessageList scrollbar thumb tracks position through unmeasured rows (#83).
- Every GPUI Kit component color follows a gpuicn token in both modes.
0.8.0
Added
- Emoji Picker:
EmojiPickerState::open, which applies recents held since the last pick. - Kbd:
key_labelfor shortcut hints outside a key cap.
Changed
- GPUI Kit 0.9.0 on
gpui-pre0.3.11, and gpui-icons 0.6.0. - The dark modal scrim is 50% black.
- Kbd and Command draw modifier and arrow symbols as icons.
Fixed
- Rounded frames in Command, Emoji Picker, Attachment, Markdown images and thumbnails no longer show square corners or lose their borders.
- Dialogs and the mobile sidebar close on a backdrop press.
- Kit colors gpuicn doesn't set, such as scrollbar tracks, follow dark mode.
- Message continuation rows don't grow when the hover time shows.
0.7.1
Changed
- No component, API or CLI changes. The website preview is smaller, so the 0.7.0 components can deploy, and releases now run entirely in CI.
0.7.0
Added
- Composer, Emoji Picker and Lightbox.
- Message: custom emoji images and who-reacted tooltips on reactions, a permalink highlight and per-row accessible descriptions.
- Message List: keyboard selection mode.
- Markdown:
selection_rootfor selecting and copying across messages,CustomEmojiinline images andMarkdownImagesfor app-supplied images. - Command: leading and trailing item slots.
Changed
- Message now depends on Tooltip in the registry.
0.6.0
Added
- Chat and app-shell components: Command, Message, Message List, Attachment,
Title Bar and Markdown (with an
EntityLinksplugin for mention and channel chips). - Small primitives: Kbd, Badge, Tag, Spinner and Skeleton.
- A
syntectfeature on thegpuicncrate that turns on code-block highlighting in Markdown.
Changed
- The theme now passes link, selection, table and code-highlight colors to
GPUI Kit. Copied-source apps should run
gpuicn add theme --overwriteso Markdown picks them up.
0.5.0
The first release without a beta suffix. gpuicn is still experimental, and APIs can change between minor versions.
Changed
- GPUI Kit 0.8.1 on its pinned
gpui-pre0.3.10 runtime (was 0.6.4 on 0.3.5). Updategpui-kit,gpui_platformandgpui-iconstogether;gpuicn initwrites the new pins. - gpui-icons 0.5.0 with Lucide 1.63.0: 1,924 icons, up from 1,818. Icons
Lucide renamed, such as
LucideIcon::Music, still compile. - The WASM build uses wasm-bindgen 0.2.127.
- The minimum Rust is now 1.98, which gpui-pre 0.3.10 needs on macOS. CI builds with 1.99.1.
0.5.0-beta.5
Added
gpuicn new <path>creates an app ready forcargo run.gpuicn initnow sets up an existing app. It adds the release's pinned Cargo dependencies, downloads Geist with checksum verification, and writes a starter window over thecargo newdefault.--config-onlykeeps the old behavior.gpuicn status,gpuicn diffandgpuicn removefor managing installed source.- A
cargo gpuicnalias is installed with the CLI. - Crate mode:
gpuicn new --crateandgpuicn init --cratedepend on thegpuicncrate instead of copying source.gpuicn eject <component>copies one component intosrc/uito edit, andgpuicn removehands it back to the crate.ui::<component>paths work the same in both modes. - The
gpuicncrate is ready for crates.io, and gpui-icons is pinned to 0.4.2. UiTheme::from_shadcn_cssimports shadcn and tweakcn theme CSS.- Component names accept
alert_dialogoralert-dialog. Unknown names suggest close matches, andaddwarns about missing Cargo dependencies.
Changed (breaking)
Component APIs now share one shape: required inputs go to new, everything
optional is a builder method, and cx is taken only when a function reads it.
Run gpuicn diff to see the new source, then update call sites:
| Before | After |
|---|---|
toasts.push(id, title, description, Some(timeout), cx) | toasts.push(id, Notice::new(title).description(description).timeout(timeout), cx); use .persistent() for no timeout |
Resizable::new(id, label, size, first, second, on_resize) | Resizable::new(id, label, size).first(first).second(second).on_resize(on_resize) |
SidebarLayout::new(id, state, mobile, sidebar, content, on_change) | SidebarLayout::new(id, state).mobile(mobile).sidebar(sidebar).content(content).on_change(on_change) |
dialog_trigger(id, &handle, cx) | dialog_trigger(id, &handle) |
dialog_action(id, &handle, cx) | dialog_action(id, &handle) |
fieldset_root(id, cx) | fieldset(id, cx) |
Changed
- Component source moved from
registry/tocrates/ui/registry/so thegpuicncrate can be packaged. Crate-internal helpers are now public but hidden from the docs, because ejected components reach them from outside. - The CLI shares the gpuicn version, and its default registry is the snapshot for that release tag rather than the live site.
- Minimum supported Rust is now 1.97 (was 1.97.1), with gpui-icons pinned to a revision that supports it.
UiTheme::readpanics with instructions to callui::theme::init(cx)when the theme is missing.- CI runs the CLI and UI tests on Linux on the minimum Rust, and sets up a new app with the CLI.
0.5.0-beta.4
GPUI Kit 0.6.4, GPUI 0.3.5 and gpui-icons 0.4.1. Adds Carousel, Empty and Input Group, and Textarea as its own install target. Notes
0.5.0-beta.3
Focus is now shown with a border color only. UiTheme::focus_ring() and
UiTheme::destructive_focus_ring() were removed. Notes
0.5.0-beta.2
Moves every component and gpuicn Workspace to GPUI Kit 0.6.1, with Kit-based input, menu, selector, form, dialog and drawer APIs. Notes
0.5.0-beta.1
Adds Sidebar, Resizable, Virtual List, the native source-installation CLI and the gpuicn Workspace example app. Notes