TUI Design

This section is the canonical record of every binding TUI design decision — architecture, navigation, chrome rules, dialogs, component reuse, and visual design. When a new decision is made, add it to the relevant page immediately.

If a proposed implementation conflicts with a rule here, fix the implementation, not the rule (or open a discussion to amend the rule first). Violations are bugs and must be fixed before a PR lands.

Every PR review that touches a TUI surface must verify the diff against these pages before producing review output.

Render paths never block: filesystem, Docker, network, sleeps, and subprocess capture report into typed state from background tasks or explicit spawn_blocking boundaries; views only read state and paint.

Pages

• Architecture — Elm Architecture layers, source code locations, boundary rules, single/multi-screen layouts, and the typed effects flow between TUI and non-TUI code.
• Navigation & Input — Key binding roles, W3C Tabs pattern, navigation hints, focusability rules, hover-scroll, scrollable blocks, and debug output constraints.
• Chrome & Surfaces — Bottom chrome layout, status bar rules, brand chrome, focus-visible borders, launch progress surface, and alternate screen continuity.
• Dialogs & Modals — Modal sizing, confirmation layout, sub-dialog stacking, wizard flows, error surface rules, hints/footer bar, and settings/editor parity.
• Component Reuse & Catalog — Hard reuse rule, the full reusable component catalog, and shared interaction patterns.
• Visual Design — PHOSPHOR color palette, border colors, left sidebar, and tab bar specifications.
• Lookbook — Live SVG previews of every shared component in jackin-tui.