DocumentationMotionCommons · Developer preview

Environment configuration

Developer preview

Configure the browser, API and workers without crossing credential boundaries.

Docs/Deploy and operate
Ask Claude

Environment configuration

Page Markdown

The complete guide, ready to copy or save as a Markdown file.

Download .md ↓

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 / fileVariablesValue type
API: root .env.localHB_SUPABASE_URL, HB_SUPABASE_PUBLISHABLE_KEYMatching target URL and publishable key
Browser: apps/web/.env.localVITE_SUPABASE_URL, VITE_SUPABASE_PUBLISHABLE_KEYSame target URL and publishable key
Launcher overrideHB_NODEPath 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.

sh
uv run python tools/dev.py --local

Telehealth settings

The web and application API do not need the monitor service credential. A review identifier is an operator attestation, not automatic compliance verification.

VariableScope and meaning
HB_TELEHEALTH_MODEServer: disabled (default), synthetic or clinical
HB_LIVEKIT_URLServer: loopback ws:// for synthetic; reviewed wss://*.livekit.cloud for clinical
HB_LIVEKIT_API_KEY / HB_LIVEKIT_API_SECRETServer-only provider credentials; secret must be at least 32 characters
HB_TELEHEALTH_REVIEW_REFERENCEServer: required nonempty review identifier in clinical mode
HB_TELEHEALTH_SERVICE_KEYDedicated monitor only: service-role JWT for the same reviewed Supabase target

Accessibility

Make every MotionCommons page comfortable for you. Settings apply on this browser.

Text size

Your training, at your pace.

Reading & movement
Audio support

Spoken audio is unavailable in this browser. All instructions remain available as text.

Read this page speaks up to 1,800 characters of visible page text. Embedded dashboards have their own Read dashboard button.