Back to writing

June 5, 2026 4 min read

Design Systems in Plain English

Design SystemsReactStorybook

Design Systems in Plain English


Design systems fail when they become theatre: polished demos, huge naming debates, and components nobody uses in production.


At Restworld, the useful parts were practical: shared components, design tokens, skeleton loaders, form patterns, and Storybook documentation that helped engineers ship consistent UI faster.


Start with Repetition


Do not build a design system from imagination. Build it from repeated product needs.


Buttons, cards, forms, modals, navbars, loaders, and empty states are boring. That is exactly why they belong in a shared system.


Documentation Should Reduce Questions


Storybook is useful when it answers how to use the component, what variants exist, and what accessibility behavior is expected.


It is less useful when it becomes a gallery detached from real product usage.


Tokens Need Ownership


Design tokens should keep visual decisions consistent, but they need clear ownership. Color, spacing, radius, typography, and motion should not drift through one-off utility choices.


My Checklist


  • Build from repeated production patterns
  • Keep component APIs small
  • Include loading, disabled, empty, and error states
  • Document accessibility expectations
  • Remove unused variants before they become debt

  • My Take


    A good design system is infrastructure. It should make the correct UI easier to ship than the inconsistent one.