This project is intentionally small. Contributions should stay focused, documented, and token-based.

Workflow

  1. Add or update a component page in src/pages/components/.
  2. Add any required styles in src/styles/global.css.
  3. Add the route in src/components/SidebarNav.tsx.
  4. Ensure examples work in light and dark mode.
  5. Run build checks before merging.

Content standards

  • Use sentence case headings.
  • Keep copy warm, specific, and plain.
  • No emoji.
  • Include: usage snippet, variants, props table, accessibility notes.

Code standards

  • Prefer design tokens over hard-coded colors/sizes.
  • Reuse existing utility/demo classes where possible.
  • Keep selectors component-scoped and readable.

Accessibility requirements

Each component doc must include:

  • Keyboard expectations
  • Screen reader label guidance
  • Focus behavior

Pull request checklist

  • Route added to sidebar
  • Docs page added/updated
  • Light + dark mode verified
  • Keyboard behavior documented
  • Build passes