¿Qué es esto?
create-bb-app es el CLI que genera un esqueleto de API NestJS a partir de las convenciones de backend-boiler.
No es un “hello world” de Nest: es una base con decisiones ya tomadas (hexagonal, calidad de código, convenciones) y un módulo de ejemplo (health-check) que demuestra el patrón de punta a punta.
Ideal si quieres un template reutilizable, listo para evolucionar con PostgreSQL + TypeORM o MongoDB + Mongoose, eventos de dominio, Swagger y Docker sin rehacer la estructura.
Relación con backend-boiler
| Pieza | Rol |
|---|---|
backend-boiler | Fuente de verdad del template Nest (arquitectura, shared kernel) |
create-bb-app | Scaffolding interactivo / flags: copia base + installers opcionales |
El template publicado vive en template/base/ y los extras en template/extras/ (postgres, mongo, events).
Stack del proyecto generado
- NestJS 11 + TypeScript + pnpm
- Arquitectura hexagonal por feature
- Vitest (unit + e2e)
- ESLint + Prettier + Husky + Commitlint
- Swagger en
api/docs - Opcional: Postgres/TypeORM o Mongo/Mongoose
- Opcional: Domain events + EventBus