Key decisions
Color: from scales to meaning
Decision Raw color scales feed semantic tokens named by role: background, card, focus, support, chips, icons, text, and border. Components reference the role, not the hex value.
Options Let components point at raw hex values.
Why Semantic tokens made dark mode possible without redrawing components. The 2026 palette restructure for light and dark modes slotted straight in.
Figma Variables as the token store
Decision Moved the system onto Figma Variables when the feature launched.
Options Keep tokens in styles and documentation only.
Why Variables hold the tokens the components use, so a token change propagates instead of being re-drawn.
Accessibility built in, not bolted on
Decision Each brand color ships with WCAG AA contrast tables. Each interactive component has an accessibility spec: the element, its accessible name, and keyboard behavior.
Options Audit for accessibility at the end of each project.
Why A contrast page sets the rules — 4.5:1 for text, 3:1 for large text and graphics — so every new page starts compliant.
Storybook as the shared catalog
Decision Built the components in Storybook with developers. Content teams use it to find and assemble components for the CMS.
Why One source of truth for tokens and states, and content teams stopped waiting on design for routine pages.