Alyson Docs

Frontend Development

How we develop the Alyson frontend.

Owner: @adminStatus: wipLast verified: 5/18/2026

Stub. Fill this in via /qa-session frontend-development or the intake-then-draft pattern.

Repo layout

Local development

How to run the frontend locally. Env vars, API target switching.

Stack

  • React (CRA → consider migration later)
  • State management
  • Routing
  • Styling system
  • Component library

Code conventions

  • File structure
  • Component naming
  • Hook patterns
  • Data fetching pattern

Auth

How auth works on the FE. Token storage, refresh, protected routes, redirect-after-login.

API integration

How the FE talks to the backend. Error handling, retry, loading state conventions.

Deployment

Vercel project, env vars, preview vs prod.