Vandoko Brand System

The complete Vandoko token profile — instance #1 of the parameterized brand token contract (ADR 0002). Every brand the registry hosts ships its own {namespace}-brand-system defining exactly the same 67 CSS custom properties with per-brand values: the contract is the variable names and structure; an instance is one brand's values. Recoloring a tenant is a values-only swap.

The token set covers ten groups: brand colors (signal-cyan #00EEFF, sand, ice), the neutral surface ladder, semantic tokens, the 5-step cool-spectrum chart palette, gauge zones, the heatmap ramp, sidebar tokens, the prestige editorial layer (--obsidian, --surface-1/2/3, shadow set), the mono cyan rank ramp, and typography.

Installation

npx shadcn@latest add @vandoko/vandoko-brand-system

Then import in your globals.css:

@import "./vandoko-brand-system.css";

Contract validation

The token contract's source of truth is lib/brand-contract-tokens.json (version 2026.06.04, date-based). Two enforcement surfaces:

• pnpm brand:lint — every brand-system CSS instance must define exactly the contract's tokens (missing or off-contract properties fail the build), and the generated @vandoko/brand-requirements schema must match the manifest.
• Portal validation — the Portal validates tenant brand profiles against the same schema at onboarding/import.

Relationship to vandoko-theme

Existing installs of vandoko-theme keep working unchanged; both items are single-sourced so they can never drift.