Preparación del entorno

Requisitos contrastados con package.json y .github/workflows/verify.yml: Node.js 22 o superior (CI usa 22), Bun 1.4.3 para el lockfile raíz, Java 17 para los emuladores de Firebase y Chromium de Playwright para las pruebas de navegador. Firebase CLI está fijado como dependencia de desarrollo; no hace falta instalarlo globalmente. Se necesita acceso de red para descargar dependencias, navegadores y el emulador en su primera ejecución.

Desde la raíz del repositorio:

bun install --frozen-lockfile
cp .env.example .env.local
npm run dev

El editor escucha en el puerto 3000 y en todas las interfaces (0.0.0.0); abrir http://localhost:3000. Revisar configuración antes de introducir credenciales: el cliente ordinario usa la configuración Firebase del repositorio y no activa emuladores automáticamente. Para trabajar sin servicios reales, usar las pruebas y sus fixtures descritas en pruebas.

El panel tiene instalación y lockfile propios:

npm --prefix apps/admin ci
npm --prefix apps/admin run dev

Vite anuncia el puerto del panel al iniciar. apps/marketing es un sitio estático sin package.json ni script de compilación. No inventar una instalación npm para esa carpeta.

La copia de .env.example no configura por sí sola el backend: contiene marcadores y una lista parcial de variables. No guardar valores secretos en git. La presencia de código local no acredita que un endpoint esté desplegado.