Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Themes and identity

Veyyon’s interface is built around near-black, near-white, and a persistent Veyyon silver accent (#B8BDC7).

Shipped themes

FileNameNotes
dark.jsonVeyyon DarkRebranded: #050505 / #FAFAFA / silver #B8BDC7
light.jsonLightUpstream oh-my-pi palette (teal accent); not yet silver-rebranded

Spec — not shipped: Veyyon Light with inverted black/white poles and a persistent silver accent.

Changing theme

  • Settings UI: /settings → Appearance → theme (or the theme picker on first run).
  • Config: theme in ~/.veyyon/agent/config.yml (profile-specific when using --profile).
  • Custom themes: drop JSON under ~/.veyyon/agent/themes/; schema in docs/theme.md.

Terminal capability detection maps the same hierarchy for truecolor, ANSI-256, ANSI-16, unknown background, and no-color modes. Reduced-motion settings remove decorative animation without hiding state changes.

What the theme covers

The contract applies to onboarding, composer, menus, dialogs, status line, markdown, tables, diffs, tool output, approvals, progress, and errors — not only the chat pane.

Identity elsewhere

  • CLI binary: veyyon
  • Config root: ~/.veyyon (PI_CONFIG_DIR overrides the directory name; XDG paths after veyyon config init-xdg)
  • npm packages: @veyyon/*

Full brand rules: Brand and identity and the repo docs/brand-system.md.