Warning: this project as been deprecated

use this project instead https://github.com/iamturns/eslint-config-airbnb-typescript as it now supports peerDependencies for airbnb-base

Airbnb's ESLint config with TypeScript support

This started as a fork from https://github.com/iamturns/eslint-config-airbnb-typescript

Setup

1) Install

this libary requires that typescript and eslint are installed

install peer dependencies

npm install @typescript-eslint/eslint-plugin @typescript-eslint/parser --save-dev

make sure you have a tsconfig.json that includes the files you want to lint or look further down if you want to create a separate tsconfig for defining which files to lint.

install eslint-config-airbnb-ts

npm install eslint-config-airbnb-ts --save-dev

2) Configure ESLint

Add "extends": ["airbnb-ts"] to your ESLint config file.

An example .eslintrc.js:

module.exports = {
  extends: ['airbnb-ts'],
};

Also note that we're enabling @typescript-eslint/eslint-plugin's recommended rules by default You can turn them off if you want but since they're recommended they should probably be enabled.

4) Configure the ESLint TypeScript parser

This config requires knowledge of your TypeScript config.

In your ESLint config, set parserOptions.project to the path of your tsconfig.json.

For example:

 module.exports = {
   extends: ['airbnb-ts'],
+  parserOptions: {
+    project: './tsconfig.json',
+ }
 };

4) Run ESLint

Open a terminal to the root of your project, and run the following command:

npx eslint . --ext .js,.jsx,.ts,.tsx

ESLint will lint all .js, .jsx, .ts, and .tsx files within the current folder, and output results to your terminal.

You can also get results in realtime inside most IDEs via a plugin.

FAQ

Does this work with JavaScript files too?

Yep! This config is just decorating eslint-config-airbnb with TypeScript support.

I get this error when running ESLint: "The file must be included in at least one of the projects provided"

This means you are attempting to lint a file that tsconfig.json doesn't include.

A common fix is to create a tsconfig.eslint.json file, which extends your tsconfig.json file and includes all files you are linting.

{
  "extends": "./tsconfig.json",
  "include": ["src/**/*.ts", "src/**/*.js", "test/**/*.ts"]
}

Update your ESLint config file:

parserOptions: {
-  project: './tsconfig.json',
+  project: './tsconfig.eslint.json',
}

I wish this config would support [...]

The goal of eslint-config-airbnb-ts is to simply decorate eslint-config-airbnb with TypeScript support. It's not a single config to cater for all TypeScript linting requirements. For additional functionality, alter your ESLint config file. For example:

module.exports = {
  extends: [
    'airbnb-ts',
    'plugin:@typescript-eslint/recommended-requiring-type-checking',
    'prettier',
  ],
};

Credits

Authored by Matt Turnbull (iamturns.com / @iamturns)

Maintained by Anders Nilsson (nilssonanders79@gmail.com)

A big thank you to all contributors!

License

Open source licensed as MIT.