TSConfig Validator#

Validates tsconfig.json files for common mistakes, conflicting options, and best practices.

Commands#

lint <file>#

Run all lint rules against a tsconfig.json file.

bash

python3 scripts/tsconfig_validator.py lint tsconfig.json
python3 scripts/tsconfig_validator.py lint tsconfig.json --strict --format json

strict <file>#

Check strictness-related options and suggest enabling strict mode.

bash

python3 scripts/tsconfig_validator.py strict tsconfig.json

compat <file>#

Check target/module compatibility issues.

bash

python3 scripts/tsconfig_validator.py compat tsconfig.json

validate <file>#

Structural validation — valid keys, types, JSON syntax.

bash

python3 scripts/tsconfig_validator.py validate tsconfig.json

Options#

• --format text|json|markdown — Output format (default: text)
• --strict — Exit 1 on warnings too (not just errors)

Rules (22)#

#RuleCategorySeverity1invalid-jsonstructureerror2unknown-compiler-optionstructurewarning3empty-configstructurewarning4missing-includestructureinfo5conflicting-include-excludestructurewarning6strict-not-enabledstrictnesswarning7no-implicit-anystrictnesswarning8strict-null-checksstrictnesswarning9no-unchecked-indexedstrictnessinfo10no-unused-localsstrictnessinfo11no-unused-paramsstrictnessinfo12outdated-targetcompatwarning13module-target-mismatchcompatwarning14jsx-without-reactcompatwarning15node-module-resolutioncompatinfo16es-interopcompatwarning17missing-outdirbest-practicesinfo18missing-rootdirbest-practicesinfo19skip-lib-checkbest-practicesinfo20source-map-in-prodbest-practicesinfo21incremental-not-enabledbest-practicesinfo22paths-without-baseurlbest-practiceserror

Exit Codes#

• 0 — No issues (or only info-level)
• 1 — Errors or warnings found (with --strict)