compiler-performance

Enable incremental compilation with the incremental flag and tsBuildInfoFile in tsconfig.json, and split the codebase using project references. This lets the compiler reuse previous build state and compile only changed projects.

Project references let you split a large TypeScript codebase into smaller interdependent projects that compile independently. Use them in monorepos or large apps where a single compilation unit causes slow builds.

Slow builds often come from expensive recursive conditional types, missing incremental compilation, or compiling one huge project without references. Deeply nested mapped types like recursive DeepPartial force the compiler into costly type evaluation.

Yes, incremental compilation stores build info in a tsbuildinfo file so subsequent type-checks reuse prior work. This reduces both command-line build times and the latency of IDE language services.

Avoid deeply recursive conditional types when they apply to large object graphs, since each instantiation multiplies compiler work. Prefer iterative or depth-limited alternatives when type-checking performance degrades.