EC
TS5093
TypeScriptERRORNotableConfigHIGH confidence

Compiler option '--X' may only be used with '--build'.

Production Risk

Build will fail; resolve before shipping.

What this means

A compiler configuration error (TS5093): Compiler option '--X' may only be used with '--build'.. This diagnostic is emitted by the TypeScript compiler when compiler option '--X' may only be used with '--build'..

Why it happens
  1. 1Incorrect TypeScript syntax or type usage
  2. 2Type mismatch between declared and actual value
How to reproduce

TypeScript compiler reports TS5093 during type checking.

trigger — this will error
trigger — this will error
// Triggers TS5093
// Compiler option '--X' may only be used with '--build'.

expected output

error TS5093: Compiler option '--X' may only be used with '--build'.

Fix

Fix the tsconfig.json option

WHEN When a compiler option is invalid or missing

Fix the tsconfig.json option
// tsconfig.json
{
  "compilerOptions": {
    // Review and correct the flagged option
  }
}
// Run: npx tsc --showConfig to see effective config

Why this works

TypeScript validates tsconfig.json options; check the official tsconfig reference for valid values.

Sources
Official documentation ↗

TypeScript Compiler Diagnostics

Content generated with AI assistance and reviewed for accuracy. Found an error? hello@errcodes.dev

← All TypeScript errors