gpuicn
Theme

Theme the previews

Every preview on the site is live GPUI and follows these.

Base
Accent
Radius
gpuicn theme set --base-color neutral --radius 0.625rem

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

Notes

Fixed

  • Alert Dialog: Escape cancels it. A press outside still does nothing.
  • Tabs: a context menu opened from on_secondary_click keeps focus, so it takes Escape, the arrows and Enter.

0.13.3

Notes

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

Notes

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

Notes

Added

  • Diff: hunk_action, a gutter button beside each hunk that reports the hunk's range, and header_visible, which hides the file headers.

0.13.0

Notes

Changed

  • Runtime pins move to GPUI Kit 0.10.0, still on gpui-pre 0.3.12 with gpui-icons 0.7.0. No gpuicn API changes; move the gpui-kit pin 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) to primary.

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

Notes

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

Notes

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

Notes

Added

  • text::INK, text::line_height and text::control in 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

Notes

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_tooltip instead 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

Notes

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

Notes

Changed

  • LinkPreview is 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

Notes

Added

  • Tab::trailing, Tab::aria_label and Tab::on_secondary_click, for tabs with a count badge and a context menu.
  • Tabs::end, Tabs::size(TabsSize::Sm) and Tabs::text_colors, for tab rows in a sidebar with a "More" menu at the end.

0.11.6

Notes

Fixed

  • A message header's name, time and header_child markers line up: the row centres its items, since GPUI reports no text baselines. Embed headers too.

Changed

  • Registry items carry a meta with since and the catalog group.
  • loop_phase steps on the executor's clock.

0.11.5

Notes

Added

  • ButtonVariant::Sidebar and ToggleVariant::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, Link button, collapsible trigger and embed toggle draw their text in link(), not primary.
  • TitleBar draws 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

Notes

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.
  • EntityLinks draws unmatched entities as plain links; only matches get a chip.
  • LinkPreview leaves out an empty site name and colors its title as a link.

0.11.3

Notes

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

Notes

Added

  • HoverPopover::passive and HoverPopover::open_requested, for a preview on a row that keeps its own click and focus.

0.11.1

Notes

Added

  • title_bar::window_drag_area, WindowControls, draws_window_controls and traffic_light_inset, for windows without a title bar.
  • Sidebar::track_scroll, Sidebar::overlay, Sidebar::header_padding and Sidebar::footer_padding.

0.11.0

Notes

Changed

  • Runtime pins move to GPUI Kit 0.9.1 on gpui-pre 0.3.12 and gpui-icons 0.7.0. No gpuicn API changes.

0.10.6

Notes

Changed

  • Message shows 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

Notes

Changed

  • Spinner and Skeleton step 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_phase and LOOP_STEPS_PER_SECOND for other looping indicators.

0.10.4

Notes

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

  • MarkdownBlocks and markdown_with, to render table cells and headings with the application's Markdown view.

0.10.3

Notes

Fixed

  • Controls claim their press: pressing one never starts a text selection, and a clickable Message row leaves the click to it.
  • Tooltips use the popover surface, so they follow light and dark mode.
  • A selected SidebarItem keeps its colors on hover.

Added

  • message::emoji_tooltip, SidebarItem::label_suffix_tooltip_view and primitives::press.

0.10.2

Notes

Added

  • Sidebar::surface and SidebarItem::surface draw a navigation on the page's muted surface instead of the sidebar colors.

0.10.1

Notes

Added

  • Rich MenuItems: .icon, .leading, .description, .trailing and .shortcut, plus MenuState::width (#174).
  • Item, ItemGroup and ItemSeparator, ported from shadcn/ui (#175).

0.10.0

Notes

Changed (breaking)

  • One-value handlers take the value by reference, the shape cx.listener returns (#168). Checkbox, Switch and Toggle on_change take &bool with no ClickEvent; Tabs and RadioGroup take &SharedString; CheckboxGroup and ToggleGroup take &[SharedString]; Calendar::on_select takes &CalendarDate; MessageList::on_select takes &Option<usize>.

0.9.13

Notes

Added

  • dialog_with and alert_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

Notes

Added

  • color_picker: hue, chroma and lightness sliders in OKLCH, plus optional swatches (matty#705).
  • Slider::gradient, for color sliders.

0.9.11

Notes

Added

  • Message::on_click, for opening a row's thread (matty#680).
  • message::reaction_tooltip with the emoji large, and message_emoji_action for one-click reactions (matty#679).

Changed

  • A chip's plain tooltip text uses the new reaction tooltip.

0.9.10

Notes

Added

  • Message::actions_with, building the hover action bar only when it shows (matty#674).

Changed

  • Message lays out its action bar only for the hovered or selected row.

0.9.9

Notes

Fixed

  • Sized Attachment images shrink with a narrow column (matty#683).
  • ShowMore's chevron is visible.

0.9.8

Notes

Added

  • SidebarItem::label_suffix and label_suffix_tooltip, for a status emoji right after a row's name (matty#681).
  • A copy button on every Markdown code block, and collapsible::ShowMore for long content (matty#682).
  • LightboxImage::dimensions, so small images keep their natural size (matty#676).
  • primitives::dismiss::on_escape, the Dismiss action and DISMISS_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

Notes

Added

  • Replaceable built-in strings: every word a component writes, from "Close" and "Search emoji" to month names and accessible labels, is a UiText with an English default that locale::set_strings translates (#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::isolate for names inside mixed-script text, and DirectionalStyled start/end helpers for your own views (#143).
  • Sortable wrap(false) and gap(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_click can rebuild its menu with set_items instead of panicking (#148).

0.9.6

Notes

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_items and set_loading for 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

Notes

Added

  • Message: on_author_click makes the name a focusable, link-styled button whose handler gets the name's bounds, and author_element replaces the name with any element, such as a popover trigger (#123).
  • Toast: Notice::on_dismiss reports why a notice left (NoticeDismissal), ToastState::contains(id) says whether one is still showing, and set_placement / set_inset move the stack (#122).

0.9.4

Notes

Added

  • Avatar: status(AvatarStatus) draws a presence dot (Online, Away, Dnd, a hollow Offline ring, or Custom) with a ring_color surface 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-support crate feature with gpuicn::audit: unnamed_controls lists interactive elements without an accessible name, and A11yAuditOverlay outlines 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

Notes

Added

  • Embed: ImagePlaceholder, a click-to-load placeholder for remote images, through LinkPreview::image_placeholder, MessageEmbed::image_placeholder and MessageEmbed::thumbnail_placeholder (#111).

0.9.2

Notes

Added

  • Embed: LinkPreview (Open Graph previews with collapse and remove) and MessageEmbed (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_popup now blocks the mouse except scrolling, so the wheel reaches modal_viewport (#109).

0.9.1

Notes

Added

  • Message timestamp_tooltip and on_gutter_click.
  • Toast Notice::action and Notice::cancel.
  • MessageList on_jump and show_jump.
  • Attachment dimensions and max_size for image thumbnails.
  • Sidebar roving_focus: one tab stop with arrow-key navigation.
  • Composer max_height, ComposerState::set_max_rows and max_rows.
  • ScrollArea track_scroll.

0.9.0

Notes

Added

  • app::run and AppConfig: one-call application start with icons, fonts, a theme pair and the first window.
  • Appearance, UiTheme::set_pair, UiTheme::set_appearance and theme::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.
  • MessageListScrollbar and MessageList::scrollbar_handle.
  • MessageDensity::Compact for 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::shadows entries are Arc<[BoxShadow]>; sidebar_is_mobile takes 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

Notes

Added

  • Emoji Picker: EmojiPickerState::open, which applies recents held since the last pick.
  • Kbd: key_label for shortcut hints outside a key cap.

Changed

  • GPUI Kit 0.9.0 on gpui-pre 0.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

Notes

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

Notes

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_root for selecting and copying across messages, CustomEmoji inline images and MarkdownImages for app-supplied images.
  • Command: leading and trailing item slots.

Changed

  • Message now depends on Tooltip in the registry.

0.6.0

Notes

Added

  • Chat and app-shell components: Command, Message, Message List, Attachment, Title Bar and Markdown (with an EntityLinks plugin for mention and channel chips).
  • Small primitives: Kbd, Badge, Tag, Spinner and Skeleton.
  • A syntect feature on the gpuicn crate 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 --overwrite so Markdown picks them up.

0.5.0

Notes

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-pre 0.3.10 runtime (was 0.6.4 on 0.3.5). Update gpui-kit, gpui_platform and gpui-icons together; gpuicn init writes 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

Notes

Added

  • gpuicn new <path> creates an app ready for cargo run.
  • gpuicn init now sets up an existing app. It adds the release's pinned Cargo dependencies, downloads Geist with checksum verification, and writes a starter window over the cargo new default. --config-only keeps the old behavior.
  • gpuicn status, gpuicn diff and gpuicn remove for managing installed source.
  • A cargo gpuicn alias is installed with the CLI.
  • Crate mode: gpuicn new --crate and gpuicn init --crate depend on the gpuicn crate instead of copying source. gpuicn eject <component> copies one component into src/ui to edit, and gpuicn remove hands it back to the crate. ui::<component> paths work the same in both modes.
  • The gpuicn crate is ready for crates.io, and gpui-icons is pinned to 0.4.2.
  • UiTheme::from_shadcn_css imports shadcn and tweakcn theme CSS.
  • Component names accept alert_dialog or alert-dialog. Unknown names suggest close matches, and add warns 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:

BeforeAfter
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/ to crates/ui/registry/ so the gpuicn crate 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::read panics with instructions to call ui::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