The Design System Shelfware Trap
A well-meaning design lead spends four months meticulously crafting a 300-page Figma component library containing 48 button variants, 16 state toggles, and complex auto-layout nested instances. It looks breathtaking in team presentations.
Fast forward six months: frontend engineers aren't using it. Why? Because the Figma components don't match the React component props, edge-case styling overrides break the code, and engineers find it faster to write custom CSS from scratch.
The Augment Rule“If a component doesn't have a 1-to-1 matching implementation in production code, it is not a design system component—it is just a drawing.”
The Lean 3-Tier Design System Architecture
Semantic Tokens
Colors, typography scale, spacing steps, shadows, and border radii defined once as CSS variables and Figma variables.
12 Core Primitives
Buttons, text inputs, checkboxes, pills, tooltips, dialogs, cards, icons, tables, tabs, toasts, and dropdowns.
Contextual Patterns
Higher-order screens assembled by combining primitives without creating redundant bespoke components.
By restricting Tier 2 to foundational primitives, both designers and engineers retain velocity without sacrificing brand consistency.