Entorno local

Pon en marcha la web y el API en tu máquina.

Levanta un entorno local

Requiere Node 18 o superior; instala en la raíz y usa npm run web:dev y npm run api:dev.

1. Instalar y ejecutar

Desde la raíz del repositorio instala dependencias y luego arranca el cliente web y el API en dos terminales (package.json en la raíz: web:dev y api:dev).

shell
cd raiz-del-monoreponpm installnpm run web:dev

En otra terminal, inicia el API (base de datos accesible y migraciones aplicadas):

shell
cd raiz-del-monoreponpm run api:dev

2. Variables de entorno

Crea archivos de entorno para apps/web y apps/api: URL pública, URL del API, base de datos, secretos de autenticación y claves de Stripe en prueba. No subas secretos al repositorio.

.env (ejemplo)
NEXT_PUBLIC_APP_URL=http://localhost:3000NEXT_PUBLIC_API_URL=http://localhost:3001

3. Estructura del proyecto

Una organización habitual en el monorepo:

  • apps/web — Next.js, sitio público, auth, workspace y UIs de admin
  • apps/api — API HTTP, webhooks y base de datos
  • apps/web/messages — JSON de i18n; el admin puede ampliar traducciones

4. Abrir la aplicación

Abre la URL del web en el navegador, completa el flujo de seed o primer usuario operador y prueba una suscripción en Stripe en modo prueba. Avisos en consola al inicio son habituales hasta completar las claves.