Ajustes
Todos los ajustes que lee el panel, su valor por defecto, el puerto y cómo cambiarlos con Docker y sin él.
Los ajustes
Todos los ajustes son opcionales: el panel funciona sin ninguno.
| Variable | Por defecto | Qué hace |
|---|---|---|
NEXT_PUBLIC_DEMO_MODE | false | true muestra en la página de inicio de sesión los datos de acceso de la demo, los rellena y muestra un selector de color flotante. Déjala desactivada para tu propio producto. |
BUILD_STANDALONE | vacío | true construye un servidor autónomo en .next/standalone. El Dockerfile lo define por ti. Déjalo vacío para yarn start. |
El puerto
El panel responde en el puerto 3030. No es una variable: los scripts dev y start de package.json pasan -p 3030, y la imagen de Docker define PORT=3030. Para usar otro puerto en una ejecución:
| Cómo lo ejecutas | En el puerto 3041 |
|---|---|
| Docker | docker run -p 3041:3030 financial-dashboard, cambiando solo el número de la izquierda de -p |
| Servidor de desarrollo | yarn dev -p 3041 |
| Versión de producción | yarn start -p 3041 |
Sin Docker
Copia .env.example a .env.local y edita allí los valores. Deja .env.example como está, como lista de lo que existe.
dashboard-template-1cp .env.example .env.localNEXT_PUBLIC_DEMO_MODE=trueCon Docker
La construcción de la imagen no lee los archivos .env ni .env.local. Pasa cada valor como argumento de construcción:
dashboard-template-1docker build -t financial-dashboard --build-arg NEXT_PUBLIC_DEMO_MODE=true .Cuándo surte efecto un cambio
Los valores que empiezan por NEXT_PUBLIC_ se compilan dentro del JavaScript que carga el navegador al construir la app. Cambiar uno no cambia nada hasta que la app se construye de nuevo:
| Cómo lo ejecutas | Después de cambiar un valor |
|---|---|
yarn dev | Detén el servidor y ejecuta yarn dev de nuevo. |
yarn build y yarn start | Vuelve a ejecutar yarn build y luego yarn start. |
| Docker | Vuelve a construir la imagen con el valor como --build-arg y luego inicia un contenedor nuevo. |
| Vercel | Cámbialo en Environment Variables del proyecto y vuelve a desplegar. |
Nunca pongas un secreto en un valor NEXT_PUBLIC_: cualquier visitante puede leerlo en el código de la página. Las claves de tus propios servicios van en tu servidor.
La construcción autónoma
Con BUILD_STANDALONE=true, yarn build escribe un servidor que no necesita node_modules en .next/standalone. El Dockerfile lo usa para mantener la imagen pequeña. yarn start no está pensado para ese tipo de construcción y avisa "next start" does not work with "output: standalone" configuration. Deja la variable vacía a menos que copies tú mismo la carpeta standalone a un servidor.