The inventory
The table below lists every environment variable the deployment reads, its purpose, its security posture, and an example of its shape. Real values are never shown here — they belong in .env.local (server-only secrets) or the deployment secret store, both outside version control.
| Variable | Required | Purpose | Example | Security |
|---|---|---|---|---|
| VITE_SUPABASE_URL | Yes | Supabase endpoint exposed in the browser bundle | https://supabase.example.com | Public (anon key only) |
| VITE_SUPABASE_PUBLISHABLE_KEY | Yes | Browser anon key | sb_publishable_… | Public by design |
| VITE_SUPABASE_PROJECT_ID | Yes | Project identifier | que | Non-secret |
| SUPABASE_URL | Yes | Server Supabase endpoint | https://supabase.example.com | Server only |
| SUPABASE_SERVICE_ROLE_KEY | Yes | Bypasses RLS — server only, never in bundles | eyJ… | Critical secret; gitignored |
| STRIPE_SECRET_KEY | If Stripe | Stripe API access | sk_live_… | Critical secret |
| STRIPE_WEBHOOK_SECRET | If Stripe inbound | Verifies inbound payment webhooks | whsec_… | Secret |
| PAYPAL_CLIENT_ID / PAYPAL_SECRET | If PayPal | PayPal provider account | client id / secret | Secret |
| SMTP_HOST / SMTP_PORT / SMTP_SECURE | Yes | Email dispatch | smtp.example.com / 465 / true | Public |
| SMTP_FROM | Yes | Sender identity | QUE <contact@example.com> | Public |
| SMTP credentials | Yes | SMTP auth | (in .env.local) | Critical secret |
| SMS provider credentials | If SMS | SMS dispatch (Twilio-class / WhatsApp provider) | (in .env.local) | Critical secret |
| BACKUP_CRON_SECRET | Yes | Authenticates the backup cron route | (bearer token) | Secret |
| NOTIFICATIONS_CRON_SECRET | Yes | Authenticates the reminder/workflow cron routes | (bearer token) | Secret |
| ALERTMANAGER_WEBHOOK_SECRET | If alerting | Fail-closed gate for the alert webhook sink | (bearer token) | Secret |
| METRICS_TOKEN | If metrics | Bearer token for GET /api/public/metrics | (bearer token) | Secret |
| SENTRY_DSN | Optional | Server error reporting | https://…@sentry/1 | Server only |
| VITE_SENTRY_DSN | Optional | Client error reporting (build-time public by design) | https://…@sentry/2 | Public DSN |
| PROJECT_NAME | Yes | Service identity in logs and reports | que | Non-secret |
| NODE_ENV | Yes | Runtime profile | production | Non-secret |
| REDIS_REST_URL | If Redis cache | REST cache endpoint (ratelimit, domain verification, ACME storage) | https://redis.example.com | Server only |
| REDIS_REST_TOKEN | If Redis cache | Bearer token for the REST endpoint | (in .env.local) | Critical secret |
| REDIS_REST_FLAVOR | If Redis cache | Adapter flavor: upstash or webdis (self-hosted Webdis) | webdis | Non-secret |
| WILDCARD_BASE_DOMAIN | If wildcard URLs | Wildcard subdomain base | example.com | Public |
Two publishable keys, two jobs
The VITE_ prefix means build-time public configuration by deliberate design; the server keeps its own private key. The runtime must export the non-VITE publishable key alongside the build-time one — inlined SSR loaders read the server key directly, and its absence is a runtime defect, not a configuration choice.