# Next.js

Source : https://webgune.cloud/de-de/docs/web-nextjs · Mis à jour le 2026-10-27

# Next.js

Das Vorhandensein von `next.config.js` oder `next.config.ts` genügt, um die Next.js-Erkennung auszulösen.

## Was der Auto-Builder ausführt

```bash
npm install
npm run build      # next build
npm start          # next start -p $PORT
```

## Standalone-Modus

Wenn Ihre Konfiguration `output: 'standalone'` aktiviert, enthält das Build-Artefakt nicht mehr dieselben Dateien und `next start` schlägt fehl. Passen Sie den Startbefehl an:

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

Siehe [Benutzerdefinierter Startbefehl](/docs/commande-demarrage) zur Konfiguration.

## Umgebungsvariablen

```bash
# Nur serverseitig verfügbar
DATABASE_URL=postgresql://user:pass@host:5432/db
API_SECRET=super-secret

# Dem Browser exponiert — Präfix erforderlich
NEXT_PUBLIC_API_URL=https://api.meine-domain.com
```

> Eine Variable ohne das Präfix `NEXT_PUBLIC_` bleibt clientseitig unsichtbar, selbst nach einem Rebuild. Das ist ein Verhalten von Next.js, keine Einschränkung von Webgune.

## API Routes und Server Actions

API-Routen (`app/api/*`) und Server Actions funktionieren ohne Anpassung. Sie laufen im selben Pod wie der Rest der Anwendung. Ein separater Dienst ist nur nötig, wenn Sie die Last isolieren möchten.