> ## Documentation Index
> Fetch the complete documentation index at: https://dhanurgo.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Environment Variables

> Complete reference for all environment variables

# Environment Variables

Copy `.env.example` to `.env.local` and fill in the values.

## Required Variables

| Variable                        | Description                   | Where to Get It                     |
| ------------------------------- | ----------------------------- | ----------------------------------- |
| `NEXT_PUBLIC_SUPABASE_URL`      | Supabase project URL          | Supabase Dashboard > Settings > API |
| `NEXT_PUBLIC_SUPABASE_ANON_KEY` | Supabase anonymous/public key | Supabase Dashboard > Settings > API |

## Optional Variables

| Variable                             | Description                       | When Needed                        |
| ------------------------------------ | --------------------------------- | ---------------------------------- |
| `SUPABASE_SERVICE_ROLE_KEY`          | Supabase admin key (bypasses RLS) | E2E test user setup, admin scripts |
| `NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY` | Stripe public key (test mode)     | Billing features                   |
| `STRIPE_SECRET_KEY`                  | Stripe secret key (test mode)     | Billing API calls                  |
| `STRIPE_WEBHOOK_SECRET`              | Stripe webhook signing secret     | Processing Stripe events           |
| `TEST_USER_EMAIL`                    | E2E test user email               | Running Playwright tests           |
| `TEST_USER_PASSWORD`                 | E2E test user password            | Running Playwright tests           |

## Example `.env.local`

```env theme={null}
# Supabase (required)
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJhbGciOiJIUzI1NiIs...

# Supabase Admin (optional)
SUPABASE_SERVICE_ROLE_KEY=eyJhbGciOiJIUzI1NiIs...

# Stripe (optional - only for billing features)
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_...
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...

# E2E Testing (optional)
TEST_USER_EMAIL=e2e.test.hostmetrics@gmail.com
TEST_USER_PASSWORD=E2ETestPassword123!
```

<Warning>
  **Never commit `.env.local` to git.** It's already in `.gitignore`. The `SUPABASE_SERVICE_ROLE_KEY` and `STRIPE_SECRET_KEY` are sensitive — never expose them in client-side code.
</Warning>

## Vercel Deployment Variables

When deploying to Vercel, add these same variables in your Vercel project settings under **Settings > Environment Variables**. Use production Supabase and Stripe keys (not test keys) for the production environment.