← Documentation
CONTRIBUTING

Add only what the system can reuse

A contribution is ready when its purpose, states, accessibility, responsive behavior, and quality evidence are clear.

Contribution sequence

  • Check the existing item and duplication risk
  • Define purpose, usage, variants, and states
  • Define keyboard and accessibility behavior
  • Define 320px behavior
  • Build the visual board or documentation
  • Run checklist, TypeScript, ESLint, and build
  • Update the relevant guide

Token additions

Add a token only when a repeated value has clear semantic meaning, cannot be represented by an existing token, or needs theme variation.