Skip to content

Archivo tsconfig.json

Este archivo define la configuración raíz de TypeScript para todo el proyecto. Actúa como punto de entrada que puede referenciar a otras configuraciones más específicas, lo que permite una estructura modular y mantenible.

  • Descripción: tsconfig.json es el archivo base que centraliza referencias a otros archivos de configuración (tsconfig.app.json y tsconfig.node.json). No contiene opciones propias de compilación, sino que sirve para organizar y estructurar los entornos de ejecución de la aplicación (por ejemplo, frontend y backend) de manera separada.
  • Propósito: Delegar la configuración de TypeScript a subarchivos que definen contextos distintos, como el entorno del navegador (tsconfig.app.json) y el entorno de Node.js (tsconfig.node.json). Esto facilita la separación de preocupaciones y mejora la escalabilidad del proyecto.
  • Funcionalidad clave:
    • files: Se deja como un arreglo vacío ([]) para que no incluya archivos directamente en este archivo raíz. Toda la inclusión de archivos es gestionada por los archivos referenciados.
    • references: Contiene rutas relativas a otros archivos de configuración de TypeScript:
      • ./tsconfig.app.json: Configuración para el código de la aplicación (por ejemplo, React/Frontend).
      • ./tsconfig.node.json: Configuración para scripts, herramientas o backend en Node.js.
  • Rol en la aplicación: tsconfig.json es el archivo de coordinación de la configuración de TypeScript. Permite el uso de Project References, lo cual acelera la compilación y facilita la integración de múltiples entornos dentro del mismo repositorio.

Contenido del archivo

json
{
  "files": [],
  "references": [
    { "path": "./tsconfig.app.json" },
    { "path": "./tsconfig.node.json" }
  ]
}