Shared Configs
ESLint shareable configurations exist to provide a comprehensive list of rules settings that you can start with.
@typescript-eslint/eslint-plugin
includes built-in configurations you can extend from to pull in the recommended starting rules.
With the exception of
all
,strict
, andstrict-type-checked
, all configurations are considered "stable". Rule additions and removals are treated as breaking changes and will only be done in major version bumps.
Getting Started
See Getting Started > Quickstart first to set up your ESLint configuration file.
Packages > typescript-eslint includes more documentation on the tseslint
helper.
// @ts-check
import eslint from '@eslint/js';
import tseslint from 'typescript-eslint';
export default tseslint.config(
eslint.configs.recommended,
...tseslint.configs.recommended,
);
Projects Without Type Checking
If your project does not enable typed linting, we suggest enabling the recommended
and stylistic
configurations to start:
- Flat Config
- Legacy Config
export default tseslint.config(
eslint.configs.recommended,
...tseslint.configs.recommended,
...tseslint.configs.stylistic,
);
module.exports = {
extends: [
'eslint:recommended',
'plugin:@typescript-eslint/recommended',
'plugin:@typescript-eslint/stylistic',
],
};
If a majority of developers working on your project are comfortable with TypeScript and typescript-eslint, consider replacing
recommended
withstrict
.
Projects With Type Checking
If your project enables typed linting, we suggest enabling the recommended-type-checked
and stylistic-type-checked
configurations to start:
- Flat Config
- Legacy Config
export default tseslint.config(
eslint.configs.recommended,
...tseslint.configs.recommendedTypeChecked,
...tseslint.configs.stylisticTypeChecked,
);
module.exports = {
extends: [
'eslint:recommended',
'plugin:@typescript-eslint/recommended-type-checked',
'plugin:@typescript-eslint/stylistic-type-checked',
],
};
If a majority of developers working on your project are comfortable with TypeScript and typescript-eslint, consider replacing
recommended-type-checked
withstrict-type-checked
.
Recommended Configurations
We recommend that most projects should extend from one of:
recommended
: Recommended rules for code correctness that you can drop in without additional configuration.recommended-type-checked
: Containsrecommended
+ additional recommended rules that require type information.strict
: Containsrecommended
+ additional strict rules that can also catch bugs but are more opinionated than recommended rules.strict-type-checked
: Containsstrict
+ additional strict rules require type information.
Additionally, we provide a stylistic
config that enforces concise and consistent code.
We recommend that most projects should extend from either:
stylistic
: Stylistic rules you can drop in without additional configuration.stylistic-type-checked
: Containsstylistic
+ additional stylistic rules that require type information.
These configurations are our recommended starting points, but you don't need to use them as-is. ESLint allows configuring own rule settings on top of extended configurations. See ESLint's Configuring Rules docs.
recommended
Recommended rules for code correctness that you can drop in without additional configuration.
These rules are those whose reports are almost always for a bad practice and/or likely bug.
recommended
also disables core ESLint rules known to conflict with typescript-eslint rules or cause issues in TypeScript codebases.
- Flat Config
- Legacy Config
export default tseslint.config(...tseslint.configs.recommended);
module.exports = {
extends: ['plugin:@typescript-eslint/recommended'],
};
See configs/recommended.ts
for the exact contents of this config.
recommended-type-checked
Contains all of recommended
along with additional recommended rules that require type information.
Rules newly added in this configuration are similarly useful to those in recommended
.
- Flat Config
- Legacy Config
export default tseslint.config(...tseslint.configs.recommendedTypeChecked);
module.exports = {
extends: ['plugin:@typescript-eslint/recommended-type-checked'],
};
See configs/recommended-type-checked.ts
for the exact contents of this config.
strict
Contains all of recommended
, as well as additional strict rules that can also catch bugs.
Rules added in strict
are more opinionated than recommended rules and might not apply to all projects.
- Flat Config
- Legacy Config
export default tseslint.config(...tseslint.configs.strict);
module.exports = {
extends: ['plugin:@typescript-eslint/strict'],
};
Some rules also enabled in recommended
default to more strict settings in this configuration.
See configs/strict.ts
for the exact contents of this config.
We recommend a TypeScript project extend from plugin:@typescript-eslint/strict
only if a nontrivial percentage of its developers are highly proficient in TypeScript.
This configuration is not considered "stable" under Semantic Versioning (semver). Its enabled rules and/or their options may change outside of major version updates.
strict-type-checked
Contains all of recommended
, recommended-type-checked
, and strict
, along with additional strict rules that require type information.
Rules newly added in this configuration are similarly useful (and opinionated) to those in strict
.
- Flat Config
- Legacy Config
export default tseslint.config(...tseslint.configs.strictTypeChecked);
module.exports = {
extends: ['plugin:@typescript-eslint/strict-type-checked'],
};
Some rules also enabled in recommended-type-checked
default to more strict settings in this configuration.
See configs/strict-type-checked.ts
for the exact contents of this config.
We recommend a TypeScript project extend from plugin:@typescript-eslint/strict-type-checked
only if a nontrivial percentage of its developers are highly proficient in TypeScript.
This configuration is not considered "stable" under Semantic Versioning (semver). Its enabled rules and/or their options may change outside of major version updates.
stylistic
Rules considered to be best practice for modern TypeScript codebases, but that do not impact program logic. These rules are generally opinionated about enforcing simpler code patterns.
- Flat Config
- Legacy Config
export default tseslint.config(...tseslint.configs.stylistic);
module.exports = {
extends: ['plugin:@typescript-eslint/stylistic'],
};
Note that stylistic
does not replace recommended
or strict
.
stylistic
adds additional rules.
See configs/stylistic.ts
for the exact contents of this config.
stylistic-type-checked
Contains all of stylistic
, along with additional stylistic rules that require type information.
Rules newly added in this configuration are similarly opinionated to those in stylistic
.
- Flat Config
- Legacy Config
export default tseslint.config(...tseslint.configs.stylisticTypeChecked);
module.exports = {
extends: ['plugin:@typescript-eslint/stylistic-type-checked'],
};
Note that stylistic-type-checked
does not replace recommended-type-checked
or strict-type-checked
.
stylistic-type-checked
adds additional rules.
See configs/stylistic-type-checked.ts
for the exact contents of this config.
Other Configurations
typescript-eslint includes a few utility configurations.
all
Enables each the rules provided as a part of typescript-eslint. Note that many rules are not applicable in all codebases, or are meant to be configured.
See configs/all.ts
for the exact contents of this config.
We do not recommend TypeScript projects extend from plugin:@typescript-eslint/all
.
Many rules conflict with each other and/or are intended to be configured per-project.
This configuration is not considered "stable" under Semantic Versioning (semver). Its enabled rules and/or their options may change outside of major version updates.
base
A minimal ruleset that sets only the required parser and plugin options needed to run typescript-eslint. We don't recommend using this directly; instead, extend from an earlier recommended rule.
This config is automatically included if you use any of the recommended configurations.
See configs/base.ts
for the exact contents of this config.
disable-type-checked
A utility ruleset that will disable type-aware linting and all type-aware rules available in our project. This config is useful if you'd like to have your base config concerned with type-aware linting, and then conditionally use overrides to disable type-aware linting on specific subsets of your codebase.
See configs/disable-type-checked.ts
for the exact contents of this config.
If you use type-aware rules from other plugins, you will need to manually disable these rules or use a premade config they provide to disable them.
- Flat Config
- Legacy Config
export default tseslint.config(
eslint.configs.recommended,
...tseslint.configs.recommendedTypeChecked,
{
languageOptions: {
parserOptions: {
projectService: true,
tsconfigDirName: import.meta.dirname,
},
},
},
{
files: ['**/*.js'],
...tseslint.configs.disableTypeChecked,
},
);
module.exports = {
extends: [
'eslint:recommended',
'plugin:@typescript-eslint/recommended-type-checked',
],
parser: '@typescript-eslint',
parserOptions: {
projectService: true,
__tsconfigRootDir: __dirname,
},
root: true,
overrides: [
{
files: ['**/*.js'],
extends: ['plugin:@typescript-eslint/disable-type-checked'],
},
],
};
This configuration is not considered "stable" under Semantic Versioning (semver). Its enabled rules and/or their options may change outside of major version updates.
eslint-recommended
This ruleset is meant to be used after extending eslint:recommended
.
It disables core ESLint rules that are already checked by the TypeScript compiler.
Additionally, it enables rules that promote using the more modern constructs TypeScript allows for.
- Flat Config
- Legacy Config
export default tseslint.config(
eslint.configs.recommended,
tseslint.configs.eslintRecommended,
);
module.exports = {
extends: [
'eslint:recommended',
'plugin:@typescript-eslint/eslint-recommended',
],
};
This config is automatically included if you use any of the recommended configurations.
See configs/eslint-recommended.ts
for the exact contents of this config.
recommended-type-checked-only
A version of recommended
that only contains type-checked rules and disables of any corresponding core ESLint rules.
This config plus recommended
is equivalent to recommended-type-checked
.
module.exports = {
extends: ['plugin:@typescript-eslint/recommended-type-checked-only'],
};
See configs/recommended-type-checked-only.ts
for the exact contents of this config.
strict-type-checked-only
A version of strict
that only contains type-checked rules and disables of any corresponding core ESLint rules.
This config plus strict
is equivalent to strict-type-checked
.
module.exports = {
extends: ['plugin:@typescript-eslint/strict-type-checked-only'],
};
See configs/strict-type-checked-only.ts
for the exact contents of this config.
This configuration is not considered "stable" under Semantic Versioning (semver). Its enabled rules and/or their options may change outside of major version updates.
stylistic-type-checked-only
A version of stylistic
that only contains type-checked rules and disables of any corresponding core ESLint rules.
This config plus stylistic
is equivalent to stylistic-type-checked
.
module.exports = {
extends: ['plugin:@typescript-eslint/stylistic-type-checked-only'],
};
See configs/stylistic-type-checked-only.ts
for the exact contents of this config.
Suggesting Configuration Changes
If you feel strongly that a specific rule should (or should not) be one of these configurations, please file an issue along with a detailed argument explaining your reasoning.
Formatting
None of the preset configs provided by typescript-eslint enable formatting rules (rules that only serve to enforce code whitespace and other trivia). We strongly recommend you use Prettier or an equivalent for formatting your code, not ESLint formatting rules. See What About Formatting? > Suggested Usage.