Brand and identity

Cross-product identity: workspace brand system. This page is how that identity shows up in the Veyyon harness (CLI, TUI, packages, config paths, docs).

Product identity

Item	Value
Product name	Veyyon (only name — not “Veyyon Code”)
Primary command	`veyyon`
Short alias	`vey`
npm scope	`@veyyon/*` (e.g. `@veyyon/pi-coding-agent`)
Config home	`~/.veyyon` (`VEYYON_CONFIG_DIR` / legacy `OMP_CONFIG_DIR` / `PI_CONFIG_DIR`)
Profile env	`VEYYON_PROFILE` (also accepts legacy `OMP_PROFILE` / `PI_PROFILE`)

Veyyon forks oh-my-pi (MIT): TypeScript/Bun agent loop and TUI, Rust natives for hot paths (grep, PTY, hashline). Upstream provenance is license and history — not a tagline to paste into Veyyon UI or docs.

Features marked > **Spec — not shipped:** are target design, not current behavior.

Legal provenance: LICENSE, NOTICE, UPSTREAM.md, Acknowledgements. OpenAI-compatible wire formats are protocol facts, not product branding.

Voice

Exact, restrained, technical. Name the product Veyyon. Prefer short factual sentences. No inherited slogans (“IDE wired in”), no second product name for the CLI, no mascot language, no unbacked capability claims.

Interface palette

Titanium (titanium.json) is the shipped default dark theme (theme.dark defaults to titanium). Veyyon Dark (dark.json) is an alternative on the same brand rules. Light (light.json) is still the upstream oh-my-pi palette until a silver light theme ships.

Theme	Status	Ground	Primary text	Brand accent	Highlight
Titanium (default)	Shipped	Pitch black `#000000`	`#e5e5e7`	Silver `#B8BDC7`	Deep blue `#4A84C9`
Veyyon Dark	Shipped	Pitch black `#000000`	`#FAFAFA`	Silver `#B8BDC7`	Deep blue `#4A84C9`
Light	Shipped (upstream)	Terminal / light gray chrome	Terminal default	Teal `#5a8080`	—

Spec — not shipped: Veyyon Light with #FAFAFA ground-inverse and silver #B8BDC7 (brand-system target).

The ground is pitch black. On it, two colors do two jobs:

Silver #B8BDC7 is the brand accent — wordmark, labels, rules, focus, progress, primary actions.
Deep blue #4A84C9 is a highlight only — one accent per view (link, caret, active state). Never a primary fill.

Green, red, and yellow only when meaning fits (success, error, warning).

Token	Value	Use
Silver	`#B8BDC7`	Brand accent
Silver bright	`#E1E4E9`	Emphasis on dark surfaces
Silver dark	`#747B86`	Secondary labels
Deep blue	`#4A84C9`	Highlight
Blue bright	`#6BA3E8`	Highlight hover

Every background is pure black #000000. Hierarchy from silver hairlines and text weight — not raised panels or tinted fills. No cyan/orange/purple/rainbow chrome. No gradients. No glow. Sharp edges.

Onboarding and installers

Fullscreen setup: Veyyon wordmark + silver progress. No secondary product name and no upstream tagline under the mark. Install/upgrade copy uses Veyyon, commands veyyon / vey only.

Session welcome is a single hero card (not a dual-column dashboard): wordmark, one value line (Hashline edits that land. Your keys.), action rows with right-aligned shortcuts, optional recent sessions. Settings is a width-capped centered panel.

Documentation contract

Identity and palette: brand system + this page.
Engine behavior: handbook pages reconciled to shipped code.
Spec — not shipped: target design until a release ships it.