Requisitos
Qué instalar antes de ejecutar tu paquete, con Docker o sin él.
Para el paquete Front + Back
Qué contiene cada paquete
| Paquete | Aplicaciones en la descarga | Funciona por sí solo |
|---|---|---|
| Full Stack | Panel y API | Sí, los dos juntos |
| Panel de administración | Panel | Sí, con su API simulada integrada y datos de ejemplo, o conectado a una API |
El código de la API de NestJS solo está en el paquete Full Stack. El paquete Admin Dashboard funciona sin ella, con datos de ejemplo guardados en tu navegador.
Con Docker
- Docker Desktop en macOS o Windows, o Docker Engine con el plugin Compose en Linux. Las dos aplicaciones se inician con un solo comando
docker compose. - Una conexión a internet para la primera construcción, que descarga las imágenes base y las dependencias.
- Nada más: Docker incluye Node.js, y la base de datos es un archivo SQLite dentro de un volumen de Docker.
Con Docker
- Docker Desktop en macOS o Windows, o Docker Engine en Linux. El panel tiene su propio
Dockerfile; no hace falta Compose. - Una conexión a internet para la primera construcción, que descarga la imagen base y las dependencias.
Sin Docker
- Node.js 22.9 o posterior. Comprueba el tuyo con
node -v. Las imágenes de Docker usan Node.js 24. - Yarn 4, a través de Corepack. Ejecuta
corepack enableuna vez; cada aplicación fija Yarn 4.8.1 en supackage.json, así queyarnusa esa versión. Node.js 25 y posteriores se distribuyen sin Corepack: ejecuta primeronpm install -g corepacky luegocorepack enable. - Ningún paquete global. Cada aplicación incluye su
yarn.lock, así queyarn installinstala las versiones exactas con las que se probó la plantilla.
Base de datos
Ningún servidor de base de datos. La API usa SQLite por defecto y yarn seed crea el archivo por ti; Docker también usa SQLite. MySQL se admite con un cambio de configuración, no de código.
Puertos
Cada aplicación escucha en un puerto local fijo. Asegúrate de que nada más los usa o, con Docker, cambia uno con DASHBOARD_PORT o API_PORT en un .env junto a docker-compose.yml.
| Aplicación | Puerto |
|---|---|
| Panel | 3030 |
| API | 8000 |
Puerto
El panel escucha en el puerto 3030. Asegúrate de que nada más lo usa, o ejecútalo en otro.
Servicios opcionales
Ninguno de estos es necesario para ejecutar el panel en local. Cada uno se activa con sus variables; si se dejan vacías, esa función queda desactivada y todo lo demás funciona.
| Servicio | Sin él |
|---|---|
| Una clave de API de Google Gemini, OpenAI o DeepSeek, en los ajustes de la API | El asistente de IA pide a cada persona su propia clave para ese proveedor, que se queda en su navegador. En la API simulada, el asistente responde a partir de los datos de ejemplo y no necesita clave. |
| Un bucket de Cloudflare R2 | No se pueden subir fotos de perfil ni archivos adjuntos del chat: la subida responde que no está configurada. En la API simulada, las imágenes se guardan en el navegador. |
| Una clave de WeatherAPI.com | El saludo del resumen se muestra sin el tiempo. |
| Una clave MCP que tú eliges | El endpoint MCP de la API rechaza todas las peticiones. |