Configuratie

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
• Leer hoe u een opdracht uitvoert en een bestand bewerkt

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