Product docs

User-facing documentation of every shipped feature. One page per user-visible flow, with light + dark screenshots and keyboard / a11y notes.

Per CLAUDE.md rule #10, every PR that changes a user-visible flow lands its matching page here in the same PR.

Index

Pages are added per ticket — see the per-phase back-fill milestones for the current list.

  • Application shell — nav, org switcher, user menu, routing (added by T115)
  • Theming — light / dark / system toggle, tokens, persistence (added by T114)
  • Authentication — signup, email verify, login, password reset (added by T103)
  • API keys & PATs — project-scoped API keys and user-scoped Personal Access Tokens (added by T110)
  • Organizations, projects, and members — real CRUD UI for tenants, projects, and role-based membership (added by T118 + T119)
  • Screenshots — capture workflow, regen command, light + dark <picture> embed pattern

Conventions

  • One page per user-visible capability. Not per ticket — a single feature spanning multiple tickets gets one page that is updated in-place.
  • Screenshots in both themes. Every screenshot is taken in light and dark modes. File names: foo-light.png, foo-dark.png.
  • Keyboard section. Every page lists the keyboard shortcuts that touch the feature, plus any ARIA landmarks used.
  • Code blocks are runnable. No pseudo-code. If a request body is shown, it works against the current API.
  • Link to the CHANGELOG entry that first introduced the feature.

Table of contents