gpui-native-kit/docs/CHECKLIST.md

gpui-native-kit — checklist

The living queue. Every element lands through the review gate: API sketch → implementation → tests → gallery panel → review. Conventions and rules live in AGENTS.md; the gpui pin lives in the workspace Cargo.toml (resolved in Cargo.lock, zed @ 504a7f2cf25b817cda3998cab93473adef15f93c). signed is the first downstream consumer; its screens drive the order.

Next

• Scrollbar (M13) — a simple way to show a scrollbar on gpui's list and uniform_list.
  • API sketch
  • Implementation (theme-baked, overlays virtualized lists)
  • Tests
  • Gallery panel
  • Review

Queue — to follow

• Code view (M14, opens crates/editor) — tree-sitter highlighting.
• Diff view (M15, editor).
• Markdown view (M16, editor) — only if a consumer confirms.
• Pickers — Calendar / DatePicker, TimeField, ColorPicker (decide at unit time).
• Layout follow-ups — persistence, pane zoom, bottom dock, collapse-to-edge; each waits for a real consumer.
• Platform screenshot passes — a Linux run (Omarchy / KDE / GNOME) and the first Windows hardware build, side by side with macOS.

Landed

theme (crates/theme)

• Theme engine — resolve overlay chain, OKLCH accent ramps, presets, per-platform elevation stacks, titlebar_height, size table (Sizable)
• Platform sources — macOS (NSColor), Windows 11 (UISettings), GNOME (portal), KDE (kdeglobals), Omarchy (colors.toml), neutral fallback; live watchers for each

icons (crates/icons)

• IconRole + bundled Lucide fallback, Segoe Fluent codepoints (Windows), freedesktop theme walker (Linux/Omarchy)

core (crates/core)

• Button, Checkbox, Switch, Radio + RadioGroup, Toggle, Link, Slider, Progress, Avatar (image + seeded pixel-art fallback)
• Spinner — painted ring + rotating-icon variant, indeterminate and determinate; replaces Tab::busy's placeholder
• Input — single-line, password with reveal, multiline, undo/redo, actions + key context, caret blink
• ScrollArea, Popover, Menu, Tooltip, Dialog / AlertDialog, Toast, Alert + alerts stack
• Select, Segmented, ContextMenu, EmptyState, Badge
• Field — label / description / error around any control, block and settings-row variants
• Status dot — colored state bead, Badge's variant vocabulary, optional screen-reader label
• Combobox — type-to-filter picker, create / keep / revert blur modes
• Command palette — filtered actions; the matcher stays caller-owned

data (crates/data)

• List, Tree, Tabs (underline default + signed pill), Sidebar (scrolls internally)

layout (crates/layout)

• ResizeHandle
• Shell — left/right sidebar regions + center, application-owned LayoutState
• Window frame — client-side decorations under Decorations::Client
• Dock — pane tree, panel registry, tab context menus
• Drag-to-split — PanelDrag payload, edge + center drop zones
• Titlebar + window controls — app-owned window dragging, per-platform buttons, Theme::titlebar_height
• Sidebar auto-open — PanelDescriptor::right_sidebar + DockSidebar

gallery (examples/gallery)

• Component browser — the shell with the catalog in its sidebar, every element a dock panel