Design system overview

The interface layer runs on a three-tier token architecture.

Tiers

• Primitive — raw values, never referenced from a component
• Semantic — meaning rather than appearance
• Component — scoped to one component

A change at the semantic tier propagates across the system without touching component code.

Baseline

Components extend shadcn/ui. Six custom components exist where the baseline had no equivalent.