Appearance
Environment Variables ​
Purpose: Define required/optional env vars with formats and redaction. Audience: Developer, Owner Prerequisites: Supabase and Stripe accounts.
Client env (.env)
VITE_SUPABASE_URL= https://YOUR_SUPABASE_PROJECT_REF.supabase.coVITE_SUPABASE_PUBLISHABLE_KEY= YOUR_SUPABASE_ANON_KEYVITE_SUPABASE_PROJECT_ID= YOUR_SUPABASE_PROJECT_REFVITE_STRIPE_PUBLISHABLE_KEY= YOUR_STRIPE_PUBLISHABLE_KEYVITE_BASE_URL= Base public URL used for robots/sitemap
Environment mapping (branches & domains)
- Stage (branch
stage):https://dev.acqmarketplace.com- Recommended vars
NODE_ENV=stagingVITE_BASE_URL=https://dev.acqmarketplace.comVITE_SUPABASE_URL/VITE_SUPABASE_PUBLISHABLE_KEYpointing to STAGING project- Stripe publishable (test):
VITE_STRIPE_PUBLISHABLE_KEY=pk_test_...
- Recommended vars
- Production (branch
main):https://acqmarketplace.com- Recommended vars
NODE_ENV=productionVITE_BASE_URL=https://acqmarketplace.com- Prod Supabase URL/anon key
- Stripe publishable (live):
VITE_STRIPE_PUBLISHABLE_KEY=pk_live_...
- Recommended vars
Edge Function env (server-side, set in Supabase)
SUPABASE_URL= https://YOUR_SUPABASE_PROJECT_REF.supabase.coSUPABASE_SERVICE_ROLE_KEY= YOUR_SUPABASE_SERVICE_ROLESTRIPE_SECRET_KEY= YOUR_STRIPE_SECRET_KEYSTRIPE_WEBHOOK_SECRET= YOUR_STRIPE_WEBHOOK_SECRETMISTRAL_API_KEY= YOUR_MISTRAL_API_KEYN8N_WEBHOOK_URL= YOUR_N8N_WEBHOOK_URL (optional)N8N_WEBHOOK_CHAT= YOUR_N8N_CHAT_WEBHOOK_URL (optional)N8N_WEBHOOK_LISTING= YOUR_N8N_LISTING_WEBHOOK_URL (optional)
Redaction policy
- Never commit real keys. Replace with placeholders in docs.
- If a secret appears in code, move to env and rotate it.
Examples
bash
# Environment variables
VITE_SUPABASE_URL="https://YOUR_SUPABASE_PROJECT_REF.supabase.co"
VITE_SUPABASE_PUBLISHABLE_KEY="YOUR_SUPABASE_ANON_KEY"
VITE_SUPABASE_PROJECT_ID="YOUR_SUPABASE_PROJECT_REF"
VITE_STRIPE_PUBLISHABLE_KEY="YOUR_STRIPE_PUBLISHABLE_KEY"
VITE_BASE_URL="https://acqmarketplace.com"Next steps
- See
docs/setup/supabase.mdfor CLI and migrations. - See
docs/setup/stripe.mdfor webhook setup. - See
docs/setup/ai-setup.mdfor AI and n8n configuration. - See
docs/operations/deployment.mdfor deploy flow (stage → main) and robots/sitemap notes.