Solución de problemas
Los errores que puedes encontrar al instalar, construir, iniciar sesión o editar el panel, qué causa cada uno y cómo solucionarlo.
Docker no se está ejecutando
failed to connect to the docker API at unix:///…/docker.sock; check if the path is correct and if the daemon is runningLas versiones antiguas de Docker muestran "Cannot connect to the Docker daemon" en su lugar. En ambos casos, el motor de Docker no está iniciado.
Abre Docker Desktop
Inicia Docker Desktop y espera a que indique que el motor está en ejecución. En Linux, inicia el servicio:
sudo systemctl start docker.Comprueba que Docker responde
Terminaldocker infoResultado esperado: Muestra una sección Server en lugar de un error.
Vuelve a ejecutar tu comando
docker build -t financial-dashboard .y luegodocker run -p 3030:3030 financial-dashboard.
Un puerto ya está en uso
Bind for 0.0.0.0:3030 failed: port is already allocated
ports are not available: exposing port TCP 0.0.0.0:3030 … bind: address already in use
Error: listen EADDRINUSE: address already in use :::3030Las dos primeras líneas vienen de Docker, la última de yarn dev o yarn start. Otro programa ya escucha en el puerto 3030: a menudo una ejecución anterior de este panel, o el servidor de otro proyecto.
Averigua qué ocupa el puerto
En macOS o Linux:
Terminallsof -i :3030En Windows, en PowerShell:
Terminalnetstat -ano | findstr :3030Detenlo
Cierra ese programa o detén la ejecución anterior: Ctrl+C en su terminal, o
docker stopcon el ID del contenedor dedocker ps. Luego inicia el panel de nuevo.O usa otro puerto
Mantén el otro programa e inicia el panel en un puerto libre, aquí
3041:Cómo lo ejecutas Comando Docker docker run -p 3041:3030 financial-dashboardServidor de desarrollo yarn dev -p 3041Versión de producción yarn start -p 3041Con Docker, cambia solo el número de la izquierda de
-p: la app dentro del contenedor siempre escucha en3030.Resultado esperado: El panel responde en localhost:3041Local.
La construcción falla
docker build se detiene con "failed to solve" y el paso que falló; yarn build se detiene con el propio error. Las causas habituales:
- Sin conexión o tiempo de espera agotado: la construcción descarga las dependencias y las fuentes Inter y Noto Sans Arabic de Google Fonts. Un mensaje como "Failed to fetch
Interfrom Google Fonts." significa que la construcción no pudo acceder a ellas. Ejecuta el comando de nuevo cuando tengas conexión; con Docker, los pasos terminados se guardan en caché. - No space left on device: libera espacio en Docker Desktop o revisa cuánto usa Docker con
docker system df. - Falla en el mismo paso cada vez: vuelve a construir sin la caché.
dashboard-template-1docker build --no-cache -t financial-dashboard .Sin Docker, elimina las carpetas node_modules y .next, y luego vuelve a ejecutar yarn install y yarn build.
Yarn dice que su versión es 1.22
This project's package.json defines "packageManager": "yarn@4.12.0". However the current global version of Yarn is 1.22…El proyecto fija Yarn 4 a través de Corepack. Este mensaje significa que Corepack aún no está activado, así que respondió un Yarn global antiguo.
corepack enableLuego vuelve a ejecutar yarn install. Usa Yarn en lugar de npm: yarn.lock es lo que mantiene tu instalación en las versiones con las que se probó la plantilla.
No se encuentra el comando corepack
corepack: command not foundNode.js 25 y posteriores ya no incluyen Corepack. Instálalo una vez con npm y luego actívalo:
npm install -g corepack
corepack enableLuego vuelve a ejecutar yarn install. Los mismos dos comandos solucionan yarn: command not found.
Node.js es demasiado antiguo
You are using Node.js 18.20.4. For Next.js, Node.js version ">=20.9.0" is required.Next.js 16 necesita Node.js 20.9 o posterior. Comprueba tu versión con node -v. Instala Node.js 22 o 24, abre una terminal nueva, ejecuta corepack enable de nuevo y luego yarn install y yarn dev.
Con Docker esto no se aplica: la imagen incluye su propio Node.js 24.
Se rechaza el inicio de sesión
The email or password is incorrect.El panel acepta una sola cuenta. Escribe sus datos de acceso exactamente: la contraseña distingue mayúsculas de minúsculas. Compruébalos en la guía de instalación.
"Please enter a valid email address" o "Password must be at least 6 characters" bajo un campo significa que el formulario se detuvo antes de comprobar la cuenta: corrige primero ese campo.
El panel me devuelve a la página de inicio de sesión
Cada página bajo /dashboard necesita un usuario con sesión iniciada, y a cualquier otro se le envía a /login. El inicio de sesión de ejemplo mantiene tu sesión solo en este navegador, así que vuelves a iniciar sesión en una ventana privada, en otro navegador, después de borrar los datos del sitio, o tras Logout en el menú de usuario o Sign Out en los ajustes.
Un ajuste cambiado no hace nada
NEXT_PUBLIC_DEMO_MODE y los demás valores NEXT_PUBLIC_ se compilan dentro de la app al construirla. 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 | Cámbialo en .env.local, detén el servidor y vuelve a ejecutar yarn dev. |
yarn build y yarn start | Cámbialo en .env.local, vuelve a ejecutar yarn build y luego yarn start. |
| Docker | Vuelve a construir la imagen con el valor como --build-arg. La construcción de la imagen ignora .env y .env.local. |
| Vercel | Cámbialo en Environment Variables del proyecto y vuelve a desplegar. |
yarn start falla o muestra una versión antigua
Could not find a production build in the '.next' directory. Try building your app with 'next build' before starting the production server.yarn start sirve la última versión de producción construida, desde la carpeta .next. Ejecuta yarn build primero, y de nuevo después de cada cambio.
Si la app muestra errores que no coinciden con tu código, a menudo después de cambiar la versión de una dependencia o BUILD_STANDALONE, borra la carpeta .next y construye de nuevo:
dashboard-template-1rm -rf .next
yarn buildEn Windows, en PowerShell, bórrala con Remove-Item -Recurse -Force .next.
El mapa del mundo sigue vacío
El mapa del mundo del resumen descarga las formas de los países desde cdn.jsdelivr.net en el navegador. Sin conexión a internet, o si un cortafuegos bloquea esa dirección, el mapa no muestra países. El resto del panel funciona sin conexión.
Un botón no hace nada o no guarda nada
Así se entrega la plantilla. No tiene back end, así que los botones que pedirían algo a un servidor están listos para tu propio código:
- Apple, Google, Remember me y Forgot password? en la página de inicio de sesión.
- Add Transaction, la transferencia rápida y la transferencia veloz: sus formularios se abren y comprueban lo que escribes, pero no se guarda nada.
- Add Card en la página de tarjetas, los botones de búsqueda y actualización del encabezado, y Save Changes y Help & Support en los ajustes.
El rango de fechas y el diálogo Filter de la página de transacciones sí funcionan: reducen la tabla en el navegador. Se abre en los últimos 30 días, que contienen todas las transacciones de ejemplo.
Un nuevo color de marca no se ve
Con el modo demo activado, el selector de color flotante guarda en el navegador el color que eliges, y esa elección prevalece sobre el color fijado en el código. Elige el mismo color en el selector o borra los datos del sitio de localhost:3030 en tu navegador. Con el modo demo desactivado, la app siempre usa el color fijado en el código.
El panel se abre en árabe
Abrir / envía al visitante a /ar cuando su navegador prefiere árabe, y a /en en caso contrario. Elige el otro idioma en el menú de idiomas del encabezado o abre /en/login directamente.
La carpeta se ve diferente
Ejecuta los comandos dentro de la carpeta en la que se extrae el ZIP, dashboard-template-1. Contiene Dockerfile, package.json, yarn.lock, messages, public y src. Si falta el comando unzip, extráelo con tu gestor de archivos; algunas herramientas añaden una carpeta extra con el nombre del ZIP, así que entra en la interior.