@hablala/create-app

Scaffolder oficial de Hablalá. Un comando crea un proyecto React Router ya cableado al SDK (@hablala/client), para que no montes tu app cliente headless desde cero. Hablalá es una plataforma horizontal: la app que generas puede ser una tienda, un portal de pacientes, un LMS… lo que tu organización construya sobre la Public API.

npm create @hablala/app@latest mi-app
# o: pnpm create @hablala/app / yarn create @hablala/app / bun create @hablala/app

El comando es interactivo: pregunta el nombre del proyecto, el template y (opcional) tu API key, copia el template, escribe .env y ofrece instalar dependencias.

Templates

| Template | Qué genera | | --- | --- | | storefront | Ejemplo de tienda headless (canal público, usuario final): catálogo, ficha de producto, reseñas, cuentas de usuario final y "mis pedidos". | | admin | App INTERNA (back-office) para los empleados de la org: login de member (mem_, RBAC), CRUD genérico de cualquier objeto del diccionario, con tabla + kanban + ficha. 100% horizontal (descubre los objetos en runtime; cero código por vertical). |

cms (páginas + colecciones + formularios) y minimal (cliente + un loader) están planeados.

Flags (para CI / no interactivo)

npm create @hablala/app@latest mi-app -- \
  --template storefront \
  --token pk_tu_key \
  --no-install

• --template <id> — elige el template sin preguntar.
• --token <pk_…> — pega la API key publishable en .env (si se omite, queda .env.example).
• --install / --no-install — fuerza o salta la instalación de dependencias.

El gestor de paquetes se detecta del que usaste para invocar (npm/pnpm/yarn/bun).

Después de crear

cd mi-app
# si no pasaste --token:  cp .env.example .env  (pega tu pk_…)
npm install
npm run dev

La API key la obtienes en el panel de Hablalá o con el CLI (@hablala/cli). La app solo lee/escribe contra tu organización según las policies del canal público; el diseño es 100% tuyo.

Guía para agentes incluida

Cada proyecto generado trae un AGENTS.md (el estándar abierto) y su espejo CLAUDE.md —mismo cuerpo neutro, generado al crear— con el modelo mental de una app cliente de Hablalá: qué es una policy default-deny, qué credencial va en cada variable, y los patrones del SDK. Para la skill completa de la plataforma en el repo: npx hablala agent setup.