Accessibility Best Practices for Modern Web Applications
Jan 5, 2025
Structuring a three-tier token architecture that supports multiple brands from a single component library without forking components.
Running multiple brands off a single component library sounds straightforward until you try it. The challenge is not the technology — CSS custom properties and build-time transforms handle the mechanics — it is the architecture of the token hierarchy and the governance model that keeps it from collapsing under the weight of brand-specific exceptions.
Global tokens (raw values: #EB5E28), alias tokens (semantic roles: --color-primary), and component tokens (scoped overrides: --button-bg) form a three-tier hierarchy. Brands swap alias tokens; components consume component tokens that reference alias tokens. Global tokens are never referenced directly in components.
The most common failure mode is teams adding brand-specific values that bypass the alias layer. A lint rule that flags direct global token references in component files, enforced in CI, catches most violations before they land.
Style Dictionary remains the most flexible build-time tool for transforming tokens into platform-specific formats. W3C Design Token Community Group format is gaining adoption and will simplify toolchain interoperability over the next two years.
Keep reading
About the author
Principal Frontend Engineer & UI/UX Director
I architect accessibility-first enterprise design systems adopted by Fortune 500 financial, insurance, and technology organizations, reducing regulatory risk and long-term development cost at scale.