# Next.js

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

# Next.js

La presencia de `next.config.js` o `next.config.ts` basta para activar la detección de Next.js.

## Lo que ejecuta el builder automático

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

## Modo standalone

Si tu configuración activa `output: 'standalone'`, el artefacto de build ya no contiene los mismos archivos y `next start` falla. Adapta el comando de inicio:

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

Ver [Comando de inicio personalizado](/docs/commande-demarrage) para configurarlo.

## Variables de entorno

```bash
# Disponibles solo en el servidor
DATABASE_URL=postgresql://user:pass@host:5432/db
API_SECRET=super-secreto

# Expuestas al navegador — prefijo obligatorio
NEXT_PUBLIC_API_URL=https://api.mi-dominio.com
```

> Una variable sin el prefijo `NEXT_PUBLIC_` permanece invisible en el cliente, incluso tras un rebuild. Es un comportamiento de Next.js, no una limitación de Webgune.

## API Routes y Server Actions

Las rutas API (`app/api/*`) y las Server Actions funcionan sin configuración adicional. Corren en el mismo pod que el resto de la aplicación: solo hace falta un servicio separado si quieres aislar la carga.