Aller au contenu
PYCOLORSDocumentation

Variables d'environnement

Configurez Starter Pro en toute sécurité avec des variables d'environnement prêtes pour la production pour l'authentification, la facturation, l'accès à la base de données, la livraison de courriels et l'infrastructure de déploiement.

Starter ProMise à jour 29 mai 2026
Starter ProVariables d'environnement

Vue d’ensembleLien vers la section

Starter Pro utilise des variables d'environnement pour séparer les problèmes d'infrastructure, d'authentification, de facturation, de livraison des e-mails et de déploiement en toute sécurité.

Ceci garde :

  • secrets en dehors du dépôt
  • Environnements prévisibles
  • Déploiement portable
  • infrastructure de facturation sécurisée
  • Authentification Production-Safe

Principe de base

Les variables d'environnement définissent les limites de l'infrastructure entre votre base de code et les systèmes de production.

Esprit de productionLien vers la section

Starter Pro est conçu autour des exigences réelles de déploiement SaaS.

Cela signifie que les variables d'environnement devraient prendre en charge:

  • développement local
  • Mise en scène des déploiements
  • infrastructure de production
  • Stripe facturation
  • Fournisseurs OAuth
  • Authentification sécurisée
  • isolation de la base de données

Sécurisé par défaut

Les secrets d'infrastructure sensibles restent côté serveur et n'atteignent jamais le navigateur.

Déploiement prêt

Les variables sont structurées pour les pipelines Vercel, CI, la mise en scène et les environnements de production.

Séparation des infrastructures

Les systèmes de base de données, d'authentification, de facturation et de messagerie restent isolés et configurables.

Modèle mentalLien vers la section

Variables publiques

Public variables are exposed to the browser and should only contain safe frontend values.

NEXT_PUBLIC_APP_URLPublic URLsFrontend-safe

Variables d'applicationLien vers la section

Ces variables définissent la structure de l'URL de l'application.

.env.local
NEXT_PUBLIC_APP_URL=http://localhost:3000
APP_BASE_URL=http://localhost:3000
Frontend

NEXT_PUBLIC_APP_URL

URL publique exposée au navigateur pour les redirections, la navigation et les références frontales.
  • coffre-fort pour frontend
  • utilisé côté client
  • domaine de production
Serveur

APP_BASE_URL

URL d'application côté serveur utilisée en interne pour les flux backend et l'infrastructure protégée.
  • Utilisation serveur uniquement
  • auth redirige
  • Références internes

Configuration de la base de donnéesLien vers la section

Starter Pro utilise PostgreSQL avec Prisma.

.env.local
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/starter_pro

Pratiques de production recommandées :

  • Hébergement PostgreSQL géré
  • sauvegardes automatisées
  • séparation de mise en scène et de production
  • connexion pooling
  • Accès restreint à la base de données

Règle de production

Ne partagez jamais les informations d'identification de la base de données de production dans des environnements locaux ou des référentiels publics.

Variables d'authentificationLien vers la section

Starter Pro utilise Auth.js pour l'authentification.

.env.local
AUTH_SECRET=
AUTH_GOOGLE_ID=
AUTH_GOOGLE_SECRET=
AUTH_GITHUB_ID=
AUTH_GITHUB_SECRET=
AUTH_TRUST_HOST=true

RequisLien vers la section

VariableObjet
AUTH_SECRETSigner des sessions et des tokens d'authentification

Fournisseurs optionnelsLien vers la section

VariableObjet
AUTH_GOOGLE_IDID client Google OAuth
AUTH_GOOGLE_SECRETLe secret du client Google OAuth
AUTH_GITHUB_IDID client GitHub OAuth
AUTH_GITHUB_SECRETGitHub OAuth client secret

NotesLien vers la section

  • AUTH_SECRET Doit être forte en production
  • Les fournisseurs OAuth sont facultatifs
  • Email/mot de passe auth fonctionne sans OAuth
  • Les domaines de production doivent correspondre à la configuration OAuth

Livraison par emailLien vers la section

Starter Pro prend en charge les flux d'e-mails transactionnels via Resend.

.env.local
AUTH_RESEND_API_KEY=
AUTH_EMAIL_FROM="PyColors <noreply@your-domain.com>"

Les flux de courrier électronique comprennent:

  • e-mails de vérification
  • mot de passe reset emails
  • livraison auth transactionnelle

Flux de vérification

La vérification des e-mails permet de sécuriser la propriété et l'intégration des comptes.

Flux de récupération

La réinitialisation du mot de passe et les flux de récupération de compte reposent sur la livraison sécurisée des e-mails.

Variables de facturation StripeLien vers la section

Starter Pro inclut des fondations de facturation Stripe prêtes pour la production.

.env.local
STRIPE_SECRET_KEY=
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=
STRIPE_WEBHOOK_SECRET=

STRIPE_PRODUCT_PRO=
STRIPE_PRICE_PRO_MONTHLY=

Variables de facturation de baseLien vers la section

VariableObjet
STRIPE_SECRET_KEYAccès Stripe côté serveur
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEYIntégration Frontend Stripe
STRIPE_WEBHOOK_SECRETValidation Webhook
STRIPE_PRODUCT_PROID produit Stripe
STRIPE_PRICE_PRO_MONTHLYID de prix Stripe

Règles importantesLien vers la section

  • Les modes test et live sont séparés
  • les produits et les prix doivent correspondre au même mode Stripe
  • La validation du webhook est requise
  • Les webhooks de production doivent utiliser HTTPS
stripe-cli.sh
stripe listen --forward-to localhost:3000/api/webhooks/stripe

Principe de facturation

La fiabilité de la facturation dépend davantage de la configuration correcte de Stripe que de la mise en œuvre frontale.

Variables de données d’exempleLien vers la section

Starter Pro comprend des équipements de développement local.

.env.local
SEED_AUTH_FIXTURES=true
SEED_DEV_USER=false

Ces variables permettent :

  • Auth Testing local
  • abonnement testing
  • Validation d'route protégée
  • flux de produits sensibles à la facturation

Configuration de production recommandéeLien vers la section

Développement

Environnement local

Utilisez les clés Stripe de test, PostgreSQL local et la configuration d'authentification sécurisée pour le développement.
  • mode de Stripe de test
  • base de données locale
  • données d’exemple
Production

Environnement de production

Utilisez l'infrastructure Stripe en direct, les secrets sécurisés, les domaines HTTPS et les paramètres de déploiement en production.
  • Live Stripe Keys
  • Base de données gérée
  • Domaines HTTPS

Exemple de fichier d'environnementLien vers la section

.env.example
# -----------------------------------------------------------------------------
# Database
# -----------------------------------------------------------------------------
DATABASE_URL=

# -----------------------------------------------------------------------------
# App
# -----------------------------------------------------------------------------
NEXT_PUBLIC_APP_URL=
APP_BASE_URL=

# -----------------------------------------------------------------------------
# Auth
# -----------------------------------------------------------------------------
AUTH_SECRET=

AUTH_GOOGLE_ID=
AUTH_GOOGLE_SECRET=

AUTH_GITHUB_ID=
AUTH_GITHUB_SECRET=

AUTH_TRUST_HOST=true

# -----------------------------------------------------------------------------
# Email
# -----------------------------------------------------------------------------
AUTH_RESEND_API_KEY=
AUTH_EMAIL_FROM=

# -----------------------------------------------------------------------------
# Stripe
# -----------------------------------------------------------------------------
STRIPE_SECRET_KEY=
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=
STRIPE_WEBHOOK_SECRET=

STRIPE_PRODUCT_PRO=
STRIPE_PRICE_PRO_MONTHLY=

— Erreurs courantes

Évitez ces erreurs de déploiement :

  • exposer publiquement des variables secrètes
  • mélange de Stripe test et live IDs
  • oubli de la configuration du webhook
  • commiting .env.local
  • Utiliser des secrets d'auth faibles
  • partage des informations d'identification de production

Règle de sécurité

Les variables d'environnement font partie de votre modèle de sécurité de l'infrastructure, et pas seulement de la configuration des applications.

Flux de travail recommandéLien vers la section

  1. Configurer des variables locales
  2. Valider les flux d'auth
  3. valider le mode de test Stripe
  4. valider la synchronisation webhook
  5. Configurer les secrets de production
  6. déployer la mise en scène
  7. valider la facturation de production
  8. lancement public

Modèle mentalLien vers la section

Les variables publiques alimentent le frontend.

Les variables serveur alimentent la couche métier.

RelatedLien vers la section

DéploiementDéployez Starter Pro avec une infrastructure et une configuration de facturation prêtes pour la production.AuthentificationComprendre les sessions, OAuth, la vérification et l'accès protégé.FacturationExplorez Stripe Checkout, les abonnements et la synchronisation de facturation.ArchitectureRevoyez la structure adaptées à la production derrière Starter Pro.

Sur cette page

Vue d’ensembleEsprit de productionConfiguration de la base de donnéesVariables d'authentificationLivraison par emailVariables de facturation StripeVariables de données d’exempleExemple de fichier d'environnementRelated