VDL Changelog

All notable changes to the Vauban Design Language.

Format follows Keep a Changelog. Versioning follows Semantic Versioning.

[5.0.0] — 2026-02-21

Added

• OKLCH Color Foundation: All colors authored in OKLCH for perceptual uniformity, compiled to hex for delivery. Generator: scripts/generate-scales.mjs (culori).
• Radix 12-Step Reference Scales: 4 neutral scales (slate, zinc, stone) + 5 accent scales (indigo, violet, amber, cyan, emerald), each with 12 purpose-bound steps.
• Three-Tier Token Architecture: Reference (static scales) → Semantic (theme-reactive) → Component (per-component aliases).
• Zone Accent Scales: Full 12-step for each product zone (Bastion/indigo, Rempart/violet, Citadel/amber, Brain/cyan, Glacis/emerald).
• Dark Mode Font Weight Compensation: +100 weight bump for headings in dark themes (halation compensation).
• Font Feature Settings: --vdl-font-features-data for tabular lining numerals in financial displays.
• Motion System v2: Spring physics easing, enter/exit curves, transaction animations (pulse-breathe, ring-expand, spring-pop), staggered list reveals.
• Display Font: Geist (--vdl-font-display) for hero, brand, and wordmark contexts.
• Logo System: Star fortress mark + wordmark + lockup in 4 variants each (dark, light, mono-white, mono-black).
• W3C DTCG tokens.json: Design Tokens Community Group compliant format.

Changed

• Semantic tokens now reference scale tokens (--vdl-bg-void: var(--vdl-slate-1)).
• Zone accents reference scales (--vdl-zone-rempart: var(--vdl-violet-9)).
• Brand aliases reference indigo scale for single source of truth.

Migration

• Fully backward compatible. All existing --vdl-* tokens resolve to same hex values.
• New reference tokens are additive -- no existing code needs changes.

---

[4.0.0] — 2026-02-20

Added

• Tailwind v4 integration layer (tailwind-v4.css)
• Motion system (motion.css) -- 10 centralized keyframes + utility classes
• Prose system (prose.css) -- Markdown and Tiptap editor styles
• Patterns system (patterns.css) -- SVG backgrounds, glass effects
• Bridge layer (bridge.css) -- Bastion legacy variable compatibility
• Version management CLI (scripts/vdl-version.sh)
• Icon registry: 70 SVG icons across 7 categories

Changed

• @custom-variant dark uses data-theme selectors (not .dark class)
• Dialog backdrop handled explicitly

---

[3.1.0] — 2026-02-14

Added

• @theme {} block for Tailwind v4 mapping (brain app)
• Explicit dialog::backdrop CSS rule

Fixed

• Dark mode selector: .dark → [data-theme="navy"], [data-theme="zinc"]

---

[3.0.0] — 2026-02-10

Added

• Initial VDL token system
• Three themes: navy (default), zinc, light (fortress stone)
• Brand indigo scale (50-950)
• Zone accent colors (5 products)
• Status colors with shade scales
• Typography, spacing, radius, shadow, z-index tokens
• Crypto and social media color constants
• Data visualization palette