calvana/THEME.md

Theme Color Conventions

Extensions in this repo use a consistent color language mapped to Pi's theme tokens. Follow these rules when building new extensions.

Color Roles

Token	Role	Used For
success	Primary value	Token counts, hash fills, branch name, counts
accent	Secondary value	Percentages, tool names, token out counts
warning	Punctuation/frame	Brackets [], parens (), pipes `
dim	Filler/spacing	Dashes, labels ("in", "out"), separators
muted	Subdued text	CWD name, fallback states

Examples

Context meter:  warning([) success(###) dim(---) warning(]) accent(30%)
Git branch:     dim(pi-vs-cc) warning(() success(main) warning())
Token stats:    success(1.2k) dim(in) accent(340) dim(out) warning($0.0042)
Tool tally:     accent(Bash) success(3) warning(|) accent(Read) success(7)

Rationale

• Green (success) draws the eye to live values that change — counts, filled bars, branch
• Cyan (accent) highlights identifiers and secondary metrics — names, percentages
• Yellow (warning) frames structure — delimiters tell you where one value ends and the next begins
• Dim recedes into the background — labels and filler shouldn't compete for attention