This package contains a set of strict shared typescript configs.

Installing

Use the package manager of your choice to install:

• npm: npm install --save-dev @cprussin/tsconfig
• pnpm: pnpm add -D @cprussin/tsconfig
• yarn: yarn add -D @cprussin/tsconfig

These configs do not set the types array, so ambient @types/* packages (e.g. @types/node, @types/bun, @types/jest) are not loaded by default. Add the ones you need in your own tsconfig.json, for example:

{
  "extends": "@cprussin/tsconfig/base.json",
  "compilerOptions": {
    "types": ["node"]
  }
}
Copy

Usage

Add the config you want to extend to your tsconfig.json, for example:

{
  "extends": "@cprussin/tsconfig/base.json"
}
Copy

Note that "noEmit": true is set by configs here. The intention is that most of the case, you're type checking with typescript and distributed untranspiled files, or that if you're transpiling then the transpilation tools you're using will override that setting in their own configs as needed. For instance, if you're using webpack, you could configure ts-loader like this:

{
  loader: "ts-loader",
  options: {
    compilerOptions: {
      sourceMap: process.env.NODE_ENV === "development",
      noEmit: false,
    },
  },
}
Copy

Or you could have a build script in your package.json that runs tsc directly:

{
  "name": "foo",
  "scripts": {
    "build": "tsc --noEmit false --outDir ./dist"
  }
}
Copy

Configurations

base.json

// tsconfig.json
{
  "extends": "@cprussin/tsconfig/base.json"
}
Copy

The base configuration that everything else extends from. Sets a bunch of strict options such as "strict": true, "allowJs": false, "noFallthroughCasesInSwitch": true, "noImplicitReturns": true, etc. If you want to be as strict as I do and you aren't incrementally adding typescript to a legacy project, you probably don't want to override most of these options, but it might make sense to override the target or lib options.

Note that no options are set for JSX or for DOM libraries. If you need any of that, you'll want to use one of the configs that extends base.json instead of using it directly.

dom.json

// tsconfig.json
{
  "extends": "@cprussin/tsconfig/dom.json"
}
Copy

Extends the base.json config by adding the dom and dom.iterable libs.

react.json

// tsconfig.json
{
  "extends": "@cprussin/tsconfig/react.json"
}
Copy

Adds the "jsx": "react-jsx" option to the dom.json config.

nextjs.json

// tsconfig.json
{
  "extends": "@cprussin/tsconfig/nextjs.json"
}
Copy

Adds the nextjs typescript plugin to the react.json config, and switches jsx to preserve along with module/moduleResolution set for bundler-based workflows.

webworker.json

// tsconfig.json
{
  "extends": "@cprussin/tsconfig/webworker.json"
}
Copy

Extends the base.json config by adding the webworker lib.