# Environment Variables Reference

> Repo-accurate environment variable guidance.

*Canonical: https://makerkit.dev/docs/nextjs-prisma/configuration/environment-variables*

---

This repo reads environment variables through standard Node/Next.js env loading plus `next-runtime-env` for public runtime values.

## Practical Repo Guidance

- keep local secrets in `./.env.local`
- use hosting-provider environment variables in production
- treat `apps/web/config/*.ts` as the source of truth for app-level config parsing

Key config files:

- `apps/web/config/app.config.ts`
- `apps/web/config/auth.config.ts`
- `apps/web/config/account-mode.config.ts`
- `apps/web/config/feature-flags.config.ts`

## Common Variables

```bash
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/postgres
BETTER_AUTH_SECRET=replace-me
NEXT_PUBLIC_SITE_URL=http://localhost:3000
NEXT_PUBLIC_PRODUCT_NAME=My App
NEXT_PUBLIC_DEFAULT_LOCALE=en
NEXT_PUBLIC_DEFAULT_THEME_MODE=light
NEXT_PUBLIC_ACCOUNT_MODE=hybrid
```

### Auth

```bash
NEXT_PUBLIC_AUTH_PASSWORD=true
NEXT_PUBLIC_AUTH_MAGIC_LINK=false
NEXT_PUBLIC_AUTH_PASSKEY=false
NEXT_PUBLIC_AUTH_OAUTH_PROVIDERS=google
NEXT_PUBLIC_DISPLAY_TERMS_AND_CONDITIONS_CHECKBOX=false
TURNSTILE_SECRET_KEY=
NEXT_PUBLIC_CAPTCHA_SITE_KEY=
```

### Billing

Billing configuration also depends on:

- `packages/billing/config/src/config.ts`
- provider-specific keys for Stripe or Polar

### Monitoring

```bash
NEXT_PUBLIC_MONITORING_PROVIDER=sentry
NEXT_PUBLIC_SENTRY_DSN=
NEXT_PUBLIC_SENTRY_ENVIRONMENT=
```

### Email

```bash
MAILER_PROVIDER=nodemailer
EMAIL_SENDER=My App <noreply@example.com>
EMAIL_HOST=
EMAIL_PORT=
EMAIL_TLS=
EMAIL_USER=
EMAIL_PASSWORD=
RESEND_API_KEY=
```

## Runtime Public Env

Client-side code should read public runtime variables with:

```ts
import { env } from '@kit/shared/env';
```

Server-side code can use `process.env`.

## Important Constraint

Do not assume the repo ships committed `./.env.local`, `./.env.local`, or `./.env.local` files. Use `./.env.local` locally and your deployment platform in production.