Documentation
Build and Development
Environment Variables
Full list of environment variables. Copy env.example to .env.local and fill in your values.
Supabase
| Variable(s) | Purpose |
|---|---|
| NEXT_PUBLIC_SUPABASE_URL | Supabase project URL |
| NEXT_PUBLIC_SUPABASE_ANON_KEY | Supabase anon (public) key |
| SUPABASE_SERVICE_ROLE_KEY | Service role key for server-side auth and DB |
APIs and services
| Variable(s) | Purpose |
|---|---|
| OPENAI_API_KEY | OpenAI for planners, probes, scoring, tasks |
| PERPLEXITY_API_KEY | Perplexity for real-time probes and citations |
| GEMINI_API_KEY | Google Gemini for AI Overviews-style probes |
| FIRECRAWL_API_KEY | Firecrawl for website crawling |
| SERPER_API_KEY | Serper for SERP data and prompt expansion |
| CLORO_API_KEY | Cloro for AI engine probes (ChatGPT, Perplexity, etc.) |
| GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET | Google OAuth (GSC, GA) |
| GOOGLE_REDIRECT_URI | OAuth callback URL (e.g. .../api/auth/google/callback) |
| BING_CLIENT_ID, BING_CLIENT_SECRET | Bing OAuth |
| BING_REDIRECT_URI | Bing OAuth callback URL |
| GOOGLE_SERVICE_ACCOUNT_EMAIL, GOOGLE_SERVICE_ACCOUNT_PRIVATE_KEY | GSC service account (alternative to OAuth) |
| GA4_PROPERTY_ID | Google Analytics 4 property for Data API |
Billing and optional
| Variable(s) | Purpose |
|---|---|
| NEXT_PUBLIC_DEMO_NOTEBOOKS | 1 = show sample notebooks when signed in with none |
| NOTEBOOK_MCP_SECRET | Optional: secret for nb_ tokens; falls back to service role |
| CEDAR_MCP_DEV_KEY | Optional: dev bypass for local MCP testing |
| AUDIT_USE_PG_NET, APP_URL, AUDIT_RUN_SECRET | Audit background jobs (production) |
| UPSTASH_REDIS_REST_URL, UPSTASH_REDIS_REST_TOKEN | Optional: Upstash QStash alternative |
| STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET, NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY | Stripe billing |
| STRIPE_PRICE_* | Stripe price IDs for each plan (Starter, Pro, Agency, monthly/annual) |
| RESEND_API_KEY | Optional: contact form emails |