Getting Started

Quickstart

This page is a quick-start for ESLint's new "flat" config format to go from zero to linting with our recommended rules on your TypeScript code as quickly as possible.

note

• For the same guide but for ESLint's legacy format — see Legacy ESLint Setup.
• For quickstart information on linting with type information — see Typed Linting.

Step 1: Installation

First, install the required packages for ESLint, TypeScript, and our tooling:

npm

npm install --save-dev eslint @eslint/js typescript typescript-eslint

Yarn

yarn add --dev eslint @eslint/js typescript typescript-eslint

pnpm

pnpm add --save-dev eslint @eslint/js typescript typescript-eslint

Step 2: Configuration

Next, create an eslint.config.mjs config file in the root of your project, and populate it with the following:

eslint.config.mjs

// @ts-check

import eslint from '@eslint/js';
import { defineConfig } from 'eslint/config';
import tseslint from 'typescript-eslint';

export default defineConfig(
  eslint.configs.recommended,
  tseslint.configs.recommended,
);

This code will enable our recommended configuration for linting.

Details

• defineConfig(...) is an optional helper function built in to current versions of ESLint. See the ESLint configuration docs for more detail.
• '@eslint/js' / eslint.configs.recommended turns on eslint's recommended config.
• tseslint.configs.recommended turns on our recommended config.

Aside on file extensions

The .mjs extension makes the file use the ES modules (ESM) format. Node interprets .js files in the CommonJS (CJS) format by default, but if you have "type": "module" in your package.json, you can also use eslint.config.js.

Step 3: Running ESLint

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

npm

npx eslint .

Yarn

yarn eslint .

pnpm

pnpm eslint .

ESLint will lint all TypeScript compatible files within the current folder, and will output the results to your terminal.

Next Steps

If you're having problems getting this working, please have a look at our Troubleshooting & FAQs.

Additional Configs

We recommend you consider enabling the following two configs:

• strict: a superset of recommended that includes more opinionated rules which may also catch bugs.
• stylistic: additional rules that enforce consistent styling without significantly catching bugs or changing logic.

eslint.config.mjs

export default defineConfig(
  eslint.configs.recommended,
  tseslint.configs.recommended,
  tseslint.configs.strict,
  tseslint.configs.stylistic,
);

You can read more about these in our shared configurations docs.

Typed Linting

We also provide a plethora of powerful rules that utilize the power of TypeScript's type information. Visit the next page for a typed rules setup guide.

Documentation Resources

• You can read more about configuring ESLint in their documentation on configuration.
• You can read more about the rules provided by ESLint in their documentation on their rules.
• You can read more about the rules provided by typescript-eslint in our rules documentation.