Next.js
Actualizat lo 2026 d’octòbre 27
Next.js
La présence de next.config.js ou next.config.ts suffit à déclencher la détection Next.js.
Ce que le builder auto exécute
npm install
npm run build # next build
npm start # next start -p $PORT
Mode standalone
Si votre config active output: 'standalone', l'artefact de build ne contient plus les mêmes fichiers et next start échoue. Adaptez la commande de démarrage :
node .next/standalone/server.js
Voir Commande de démarrage personnalisée pour la configurer.
Variables d'environnement
# Disponibles uniquement côté serveur
DATABASE_URL=postgresql://user:pass@host:5432/db
API_SECRET=super-secret
# Exposées au navigateur — préfixe obligatoire
NEXT_PUBLIC_API_URL=https://api.mon-domaine.com
Une variable sans le préfixe
NEXT_PUBLIC_reste invisible côté client, même après un rebuild. C'est un comportement de Next.js, pas une limitation de Webgune.
API Routes et Server Actions
Les routes API (app/api/*) et Server Actions fonctionnent telles quelles. Elles tournent dans le même pod que le reste de l'application : pas besoin de service séparé, sauf si vous voulez isoler la charge.