> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vinum-elabel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Environment variables

> Environment variables required to build and run the Vinum E-Label application.

<Note>
  This page is for developers working on the Vinum E-Label application itself.
</Note>

The Vite app reads its public Supabase configuration from environment variables at build time.

## Required variables

| Variable                 | Purpose                                           |
| ------------------------ | ------------------------------------------------- |
| `VITE_SUPABASE_URL`      | Supabase project URL                              |
| `VITE_SUPABASE_ANON_KEY` | Supabase anon (public) key for client-side access |

Both values are safe to expose to the browser — access control is enforced by row-level security on the database, not by keeping these values secret.

## Local setup

```bash theme={null}
cp .env.example .env.local
```

Fill in the values from your Supabase project settings. The repository intentionally does not track `.env` or `.env.*` files.

## Production setup

Configure the same variables in the hosting platform that builds the app (Cloudflare Pages). Server-side secrets — Stripe keys, webhook secrets — live in Supabase edge function configuration, never in `VITE_*` variables.

## Supabase services in use

* Authentication (including magic-link sign-in)
* PostgreSQL with row-level security
* Storage (QR code SVGs)
* Edge functions (billing webhooks, label import)

Review RLS policies and edge function environment values before promoting a new deployment.