Requisitos
Qué instalar antes de ejecutar tu paquete, con Docker o sin él.
Para el paquete Full Stack
Qué contiene cada paquete
| Paquete | Aplicaciones en la descarga | Funciona por sí solo |
|---|---|---|
| Full Stack | API, tienda, panel de administración | Sí, las tres juntas |
| Tienda | Tienda | Sí, con una tienda de ejemplo integrada hasta que conectes la API de la plantilla |
| Panel de administración | Panel de administración | Sí, con una tienda de ejemplo integrada hasta que conectes la API de la plantilla |
| API Backend | API | Sí, solo sirve la API |
Un paquete de una sola aplicación no incluye las demás. Los frontends pueden usar una API que ya tengas en marcha, pero el código de la API solo está en los paquetes Full Stack y API Backend.
Con Docker
- Docker Desktop en macOS o Windows, o Docker Engine con el plugin de Compose en Linux. El paquete Full Stack se inicia 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. Tu aplicación tiene su propio
Dockerfile; no necesitas Compose. - Una conexión a internet para la primera construcción, que descarga la imagen base y las dependencias.
Sin Docker
- Node.js 22 o posterior. La plantilla se prueba con Node.js 24, que también usan sus imágenes de Docker. La tienda por sí sola también funciona con Node.js 20.9.
- Yarn 4, a través de Corepack. Ejecuta
corepack enableuna vez; cada aplicación fija su propia versión de Yarn, así queyarnelige la correcta. Si tu Node.js no trae Corepack, instálalo antes connpm install -g corepack. - Ningún paquete global.
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 use o, con Docker, mueve uno con SITE_PORT, ADMIN_PORT o API_PORT en un .env junto a docker-compose.yml.
| Aplicación | Puerto |
|---|---|
| API | 8000 |
| Tienda | 3030 |
| Panel de administración | 3031 |
Puerto
La tienda escucha en el puerto 3030. Asegúrate de que nada más lo use.
Puerto
El panel de administración escucha en el puerto 3031. Asegúrate de que nada más lo use.
Puerto
La API escucha en el puerto 8000. Asegúrate de que nada más lo use.
Una API a la que conectarse
No necesitas nada para probar tu aplicación: funciona con su propia tienda de ejemplo. Para usar datos reales, necesita la API de la plantilla en ejecución, cuya dirección configuras en su .env. La API se vende como un paquete propio.
Servicios opcionales
Nada de esto es necesario para ejecutar la tienda en local. Cada uno se activa con sus claves en back-end/.env, y una clave que se deja con su valor de .env.example cuenta como no configurada.
| Servicio | Sin él |
|---|---|
| Cloudflare R2 u otro bucket compatible con S3 | Las imágenes de la tienda de demostración se sirven desde copias que incluyen ambos frontends. Subir imágenes nuevas responde 503 hasta que se configure un bucket. |
| Stripe | No se cobra ningún pago con tarjeta: la opción de tarjeta del pago indica que los pagos con tarjeta no están disponibles, y el pago contra reembolso funciona con normalidad. |
| Una clave de Google AI (Gemini) | El asistente del panel, el modo Assistant del estudio (redactar los detalles del producto y editar fotos) y el probador de la tienda indican que están desactivados. El estudio y el probador también necesitan el bucket. |
| Una clave y un secreto de Higgsfield | El modo Animate del estudio, que crea videos del producto, indica que está desactivado. |
| El archivo del modelo de eliminación de fondo | El botón "Remove background" del estudio no aparece. Funciona en tu propio servidor, necesita el bucket para sus resultados y no cuesta nada por imagen. |