Featured image of post Referencias de proyecto en TypeScript: Código base a escalaFeatured image of post Referencias de proyecto en TypeScript: Código base a escala

Referencias de proyecto en TypeScript: Código base a escala

TypeScript Project References for scaling large codebases. Composite projects, build mode, incremental builds, monorepo integration, and CI optimization.

Project References permiten dividir un código base grande en proyectos más pequeños que dependen entre sí. Mejoran tiempos de compilación y habilitan compilación incremental.

Configuración

Cada subproyecto tiene su tsconfig.json con composite: true. El proyecto raíz usa references para apuntar a cada subproyecto.

Modo build

tsc --build compila proyectos en orden topológico. Solo recompila los que cambiaron. tsc --build --force para reconstrucción completa.

Patrones de estructura

Monolito modular: packages/*/tsconfig.json. Separación cliente/servidor. Bibliotecas compartidas con sus propias referencias.

Beneficios

Compilación más rápida (solo lo necesario), mejor encapsulamiento (cada proyecto solo ve sus dependencias), integración con monorepos.