Configura el compilador con criterio para DX, builds fiables y deuda técnica controlada.
TSConfig define la política técnica del proyecto: qué riesgos aceptas y qué garantías exiges en compilación.
Una configuración correcta reduce deuda y evita bugs de integración entre equipos y repositorios.
No existe un tsconfig universal: cada proyecto equilibra velocidad de entrega y rigor según contexto.
La meta es construir un baseline sostenible que permita escalar sin convertir el compilador en obstáculo.
Strict no es todo o nada; puedes activarlo por fases para no bloquear roadmap.
Comienza por reglas con mayor retorno (noImplicitAny, strictNullChecks) en código nuevo.
En legado, usa planes de migración por carpetas o dominios para reducir impacto en entregas.
Mide progreso con métricas simples: número de any explícitos, warnings críticos y módulos pendientes.
Opciones de module/target/resolution afectan runtime real, no solo tipos.
Alinea target con navegadores/Node soportados; configurar uno demasiado moderno puede romper producción silenciosamente.
Define module según tu bundler y entorno para evitar incompatibilidades entre import/export y tooling.
Usa source maps y declarations con intención: ayudan en debugging y consumo externo, pero tienen coste de build.
La calidad no depende solo del tsconfig; depende del flujo completo de desarrollo.
Configura scripts de typecheck en pre-commit o CI para detectar roturas antes de mergear.
Alinea reglas de lint con tipos para evitar contradicciones entre lo que permite ESLint y bloquea tsc.
Documenta convenciones de configuración para que nuevas personas no rompan pipeline por desconocimiento.
Configura el compilador con criterio para DX, builds fiables y deuda técnica controlada.
Código del tema: arquitectura de compilación
Strict no es todo o nada; puedes activarlo por fases para no bloquear roadmap.
Comienza por reglas con mayor retorno (noImplicitAny, strictNullChecks) en código nuevo.
En legado, usa planes de migración por carpetas o dominios para reducir impacto en entregas.
Mide progreso con métricas simples: número de any explícitos, warnings críticos y módulos pendientes.
Opciones de module/target/resolution afectan runtime real, no solo tipos.
Alinea target con navegadores/Node soportados; configurar uno demasiado moderno puede romper producción silenciosamente.
Define module según tu bundler y entorno para evitar incompatibilidades entre import/export y tooling.
Usa source maps y declarations con intención: ayudan en debugging y consumo externo, pero tienen coste de build.
La calidad no depende solo del tsconfig; depende del flujo completo de desarrollo.
Configura scripts de typecheck en pre-commit o CI para detectar roturas antes de mergear.
Alinea reglas de lint con tipos para evitar contradicciones entre lo que permite ESLint y bloquea tsc.
Documenta convenciones de configuración para que nuevas personas no rompan pipeline por desconocimiento.