Documentation / guides
Styling
Use the leaf styles package for shared terminal colors, rails, cards, fills, and markdown rendering.
The github.com/looprig/tui/styles package is a leaf package over Lip Gloss and Glamour. It owns shared terminal styles, color tokens, background fill helpers, markdown configuration, and semantic tool-node rendering. It does not import tui, components, or Harness, so a component can use the same visual vocabulary without creating a package cycle.
Leaf boundary
%%{init: {"theme":"dark"}}%%
flowchart LR
C[components] --> S[styles]
P[internal presentation] --> S
S --> L[lipgloss]
S --> G[glamour]
S -. no dependency .-> T[tui package]The public variables are shared style values. They are exported for component composition, not as a runtime theme registry. A host can use the tokens directly, but should preserve the semantic distinction between user rails, action cards, status text, tool nodes, and selection fills.
Shared vocabulary
The package exposes the AccentBar, Dot, SubagentCursor, and workflow markers used by transcript rows. It also exposes role styles such as UserStyle, ThinkingStyle, StatusStyle, ToolCallStyle, and ToolResultStyle, plus card and tray styles. NoticeStyle(level) maps info, warning, and error levels to a safe style, with unknown values falling back to neutral info.
FillLineBackgroundWith is the modern full-width fill primitive. It reopens the background after inner ANSI resets and pads to display width, so a styled markdown span cannot punch a hole in a composer or card panel.
Styling pages
- Styles and Layout Tokens catalogs the semantic styles and background helpers.
- Markdown Rendering covers Glamour configuration and responsive table rendering.
There is no public keymap or layout package in the TUI module. Key bindings and frame layout are internal presentation policy. Compose public style values around a Screen or component instead of depending on internal view structs.