30. Design System Review Checklist

Review foundations, tokens, components, engineering, governance, and analytics.

Foundations

  • Design principles documented
  • Terminology documented
  • Brand rules documented
  • Accessibility baseline defined
  • Responsive strategy defined

Tokens

  • Primitive tokens exist
  • Semantic tokens exist
  • Components avoid raw visual values
  • Light/dark themes map semantic roles
  • Token naming is stable
  • Token output can be consumed programmatically

Typography

  • Type scale
  • Line height
  • Weights
  • Responsive rules
  • Font-loading strategy

Color

  • Primitive palette
  • Semantic roles
  • Functional states
  • Accessible combinations
  • Dark mode

Layout

  • Spacing scale
  • Breakpoints
  • Grid
  • Containers
  • Responsive rules

Components

  • API documented
  • states documented
  • variants documented
  • keyboard behavior documented
  • screen-reader behavior documented
  • responsive behavior documented
  • unit/component tests
  • accessibility tests
  • visual regression tests
  • Storybook examples

Engineering

  • TypeScript
  • linting
  • formatting
  • CI
  • semantic versioning
  • changelog
  • release automation
  • contribution guide

Governance

  • ownership defined
  • proposal process
  • review process
  • deprecation policy
  • migration policy
  • communication channel

Analytics

  • adoption metrics
  • package-version metrics
  • component usage
  • error monitoring
  • consumer feedback

On this page