> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Configuratie

Houd applicatieconfiguratie expliciet en providercredentials op de server.

## Breng één configuratiewijziging aan en controleer deze

Begin met een actieve web-app. Open in de editor apps/web/.env.local; als het niet bestaat, kopieer dan .env.example daarheen met behulp van de webtutorial. Voor een ongevaarlijke eerste controle zoekt u EMAIL_PROVIDER=local op en laat u deze lokaal staan. Deze instelling stuurt product-e-mail naar de lokale preview in plaats van naar een echte inbox. Plak geen KEY=value-regels in de terminal.

Voor elke service die u inschakelt, volgt u de installatiehandleiding van die provider, vervangt u alleen de genoemde waarden, slaat u het bestand op, stopt u de webserver met Ctrl + C en start u opnieuw op met de onderstaande opdracht. Als bij de validatie een ontbrekende sleutel wordt genoemd, heropent u dit bestand en vergelijkt u die sleutel met de handleiding van de provider. Houd root .env alleen gesynchroniseerd voor waarden die worden gebruikt bij databasemigraties; als u het alleen kopieert, wordt Next.js niet geconfigureerd.

[Een configuratiesleutel opzoeken](https://supastack.dev/nl/docs/web/project-structure.md)

[Leer hoe u een opdracht uitvoert en een bestand bewerkt](https://supastack.dev/nl/docs/web/terminal-basics.md)

```
corepack pnpm --filter @supastack/web dev
```


## De instellingen die u echt als eerste bewerkt

`.env.example` in de root van de repository is de volledige inventaris van instellingen die de kit begrijpt; een naam die niet in dat bestand staat, bestaat niet. In het begin raakt u er maar een handvol aan — de rest blijft op zijn standaardwaarden staan tot een providerhandleiding erom vraagt.

Welk bestand elke app leest: root `.env` voedt de migratieopdrachten, `apps/web/.env.local` voedt de Next.js-server en `apps/mobile/.env.local` voedt Expo. Het bewerken van één bestand configureert de andere niet, dus `DATABASE_URL` staat zowel in root `.env` als in `apps/web/.env.local`.

- `APP_URL` — het adres waarop de app draait; `http://localhost:3000` lokaal, uw domein in productie.
- `DATABASE_URL` — de Postgres-verbindingsreeks die migraties en de server delen.
- `AUTH_SECRET` en `CREDENTIAL_ENCRYPTION_KEY` — gegenereerde geheimen; `node scripts/setup-env.mjs` vult ze voor u in (die helper wordt meegeleverd in de webrepository en de All Platforms-monorepo).
- De providerselectoren — `EMAIL_PROVIDER`, `AI_PROVIDER`, `BILLING_PROVIDER`, `JOB_PROVIDER`, `CAPTCHA_PROVIDER` — kiezen elk welke adapter draait; de `local`/`fake`/`off`-standaardwaarden vereisen geen account.
- Providergeheimen zoals `RESEND_API_KEY` of `STRIPE_SECRET_KEY` — voeg ze alleen toe wanneer de bijbehorende providerhandleiding dat zegt.


## Begin met het environment-voorbeeld

De root-.env.example is de configuratie-inventaris. Gedeelde validatie leeft in packages/config. Review de gekozen applicatie-omgeving en providermodi samen; een lokale interface is geen productie-credentialstrategie.

De credentialvrije referentiemodus vereist lokale/test-applicatieconfiguratie en fake/lokale providers. Een productieprovider kiezen verandert de runtimevereisten.


## Houd secrets achter de API

Authenticatiesecrets, databasecredentials, providerkeys, Stripe-secrets en Trigger-credentials zijn server-only. Prefix ze nooit met NEXT_PUBLIC_ of EXPO_PUBLIC_. Print ze niet tijdens setup en neem ze niet op in errorresponses.

De browser ontvangt publieke configuratie en toegestane modelaliasen. Workspace-eigenaarschap, entitlementbeslissingen, budgetten en providerselectie blijven server-afgedwongen.


## Check een wijziging vóór gebruik

Valideer configuratie via het bestaande config-package en draai de relevante deterministische tests. Gebruik het apart opt-in provider-smokepad wanneer je klaar bent om echte integraties te verifiëren.

```
corepack pnpm test
corepack pnpm check
corepack pnpm build
```


Wil je verdergaan met de configuratie? Lees [Database instellen](https://supastack.dev/nl/docs/web/setup-database.md).


## Volgende

[Bouw je eerste feature](https://supastack.dev/nl/docs/web/first-feature.md)