thalos-web/docs/runbooks/local-development.md

Local Development

Install

npm install

Run

VITE_API_BASE_URL=http://localhost:8080 \
VITE_THALOS_AUTH_BASE_URL=http://localhost:20080 \
VITE_THALOS_DEFAULT_RETURN_URL=http://localhost:22080/callback \
VITE_THALOS_DEFAULT_TENANT_ID=demo-tenant \
VITE_THALOS_ENABLE_MANUAL_LOGIN=true \
npm run dev

Auth Model

• Central login starts via GET /api/identity/oidc/google/start.
• Callback route validates query parameters and resolves session by calling refresh/me endpoints.
• Session cookies are sent with credentials: include.
• Manual session login is available locally by setting VITE_THALOS_ENABLE_MANUAL_LOGIN=true.

Build

npm run build

Test

npm run test:ci

See also: docs/runbooks/testing.md