Environment configuration
Configure the browser, API and workers without crossing credential boundaries.
Public preview
The public website and documentation need no Supabase settings. Node 24 and the installed Python environment are sufficient for the local launcher. Study workspace access requires the configuration below.
Workspace settings
Copy the corresponding .env.example templates and supply your intended target. Environment files are ignored by Git. Restart the web/API processes after changing configuration.
VITE variables are public browser build inputs. Never put service-role credentials, API secrets or private worker credentials there. Application API requests retain the caller identity and database access policies.
| Process / file | Variables | Value type |
|---|---|---|
| API: root .env.local | HB_SUPABASE_URL, HB_SUPABASE_PUBLISHABLE_KEY | Matching target URL and publishable key |
| Browser: apps/web/.env.local | VITE_SUPABASE_URL, VITE_SUPABASE_PUBLISHABLE_KEY | Same target URL and publishable key |
| Launcher override | HB_NODE | Path to an installed Node 24 executable |
Select local mode explicitly
Use the documented local Supabase stack and synthetic identities. The explicit local launcher preserves hosted configuration files. Add --inspect only when ffprobe and the local execution prerequisites are ready.
uv run python tools/dev.py --localTelehealth settings
The web and application API do not need the monitor service credential. A review identifier is an operator attestation, not automatic compliance verification.
| Variable | Scope and meaning |
|---|---|
| HB_TELEHEALTH_MODE | Server: disabled (default), synthetic or clinical |
| HB_LIVEKIT_URL | Server: loopback ws:// for synthetic; reviewed wss://*.livekit.cloud for clinical |
| HB_LIVEKIT_API_KEY / HB_LIVEKIT_API_SECRET | Server-only provider credentials; secret must be at least 32 characters |
| HB_TELEHEALTH_REVIEW_REFERENCE | Server: required nonempty review identifier in clinical mode |
| HB_TELEHEALTH_SERVICE_KEY | Dedicated monitor only: service-role JWT for the same reviewed Supabase target |