# Next.js

Source : https://webgune.cloud/oc-oc/docs/web-nextjs · Mis à jour le 2026-10-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

```bash
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 :

```bash
node .next/standalone/server.js
```

Voir [Commande de démarrage personnalisée](/docs/commande-demarrage) pour la configurer.

## Variables d'environnement

```bash
# 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.