# eslint-config-eslint

> Default ESLint configuration for ESLint projects.

Latest version **14.0.0** (published 2026-03-06) · MIT license · 0 weekly downloads

## Install

```sh
npm install eslint-config-eslint
pnpm add eslint-config-eslint
yarn add eslint-config-eslint
bun add eslint-config-eslint
```

## Health

**Score 70/100 (B)** — status: stable.

Positive: has types; esm support; no vulnerabilities; high maintenance score; high quality score; popular repo.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 14.0.0 |
| Published | 2026-03-06 |
| First published | 2015-10-15 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | ^20.19.0 \|\| ^22.13.0 \|\| >=24 |
| Dependencies | 6 |
| Unpacked size | 20.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 27518 |
| Author | Nicholas C. Zakas |
| Maintainers | openjsfoundation, eslintbot |
| Keywords | eslintconfig, eslint-config, eslint |

## Links

- npm: https://www.npmjs.com/package/eslint-config-eslint
- Repository: https://github.com/eslint/eslint
- Homepage: https://eslint.org
- Issues: https://github.com/eslint/eslint/issues/
- Funding: https://eslint.org/donate
- npm.io page: https://npm.io/package/eslint-config-eslint

## Dependencies (6)

- [@eslint/js](https://npm.io/package/@eslint/js.md) ^10.0.1
- [eslint-plugin-n](https://npm.io/package/eslint-plugin-n.md) ^17.11.1
- [eslint-plugin-jsdoc](https://npm.io/package/eslint-plugin-jsdoc.md) ^62.7.0
- [eslint-plugin-regexp](https://npm.io/package/eslint-plugin-regexp.md) ^2.10.0
- [eslint-plugin-unicorn](https://npm.io/package/eslint-plugin-unicorn.md) ^52.0.0
- [@eslint-community/eslint-plugin-eslint-comments](https://npm.io/package/@eslint-community/eslint-plugin-eslint-comments.md) ^4.7.1

## Alternatives

- [eslint-plugin-sonarjs](https://npm.io/package/eslint-plugin-sonarjs.md) — 2.9M weekly downloads
- [eslint-config-expo](https://npm.io/package/eslint-config-expo.md) — 1.5M weekly downloads
- [@matter/protocol](https://npm.io/package/@matter/protocol.md) — 63.5K weekly downloads
- [@eventcatalog/linter](https://npm.io/package/@eventcatalog/linter.md) — 24.8K weekly downloads
- [@inrupt/eslint-config-base](https://npm.io/package/@inrupt/eslint-config-base.md) — 4.5K weekly downloads

## Recent versions

- 14.0.0 (latest) — 2026-03-06
- 13.0.0 — 2025-09-05
- 12.0.0 — 2025-08-22
- 11.0.0 — 2024-06-06
- 10.0.0 — 2024-04-29
- 9.0.0 — 2023-07-28
- 8.0.0 — 2023-06-30
- 7.0.0 — 2021-02-05
- 6.0.0 — 2019-12-20
- 5.0.1 — 2018-07-11
- 5.0.0 — 2018-07-08
- 4.0.0 — 2017-02-20
- 3.0.0 — 2016-02-02
- 2.0.0 — 2016-01-15
- 1.0.1 — 2015-10-15
- … 1 more at https://npm.io/package/eslint-config-eslint/versions

## README

[![npm version](https://img.shields.io/npm/v/eslint-config-eslint.svg)](https://www.npmjs.com/package/eslint-config-eslint)
[![Downloads](https://img.shields.io/npm/dm/eslint-config-eslint.svg)](https://www.npmjs.com/package/eslint-config-eslint)
[![Build Status](https://github.com/eslint/eslint/workflows/CI/badge.svg)](https://github.com/eslint/eslint/actions)
<br>
[![Open Collective Backers](https://img.shields.io/opencollective/backers/eslint)](https://opencollective.com/eslint)
[![Open Collective Sponsors](https://img.shields.io/opencollective/sponsors/eslint)](https://opencollective.com/eslint)

# ESLint Configuration

[Website](https://eslint.org) |
[Configure ESLint](https://eslint.org/docs/latest/use/configure) |
[Rules](https://eslint.org/docs/rules/) |
[Contribute to ESLint](https://eslint.org/docs/latest/contribute) |
[Report Bugs](https://eslint.org/docs/latest/contribute/report-bugs) |
[Code of Conduct](https://eslint.org/conduct) |
[X](https://x.com/geteslint) |
[Discord](https://eslint.org/chat) |
[Mastodon](https://fosstodon.org/@eslint) |
[Bluesky](https://bsky.app/profile/eslint.org)

Contains the ESLint configuration used for projects maintained by the ESLint team.

## Installation

You can install ESLint using npm or other package managers:

```shell
npm install eslint -D
# or
yarn add eslint -D
# or
pnpm install eslint -D
# or
bun add eslint -D
```

Then install this configuration:

```shell
npm install eslint-config-eslint -D
# or
yarn add eslint-config-eslint -D
# or
pnpm install eslint-config-eslint -D
# or
bun add eslint-config-eslint -D
```

## Usage

### ESM (`"type":"module"`) projects

In your `eslint.config.js` file, add:

```js
import { defineConfig } from "eslint/config";
import eslintConfigESLint from "eslint-config-eslint";

export default defineConfig([eslintConfigESLint]);
```

**Note**: This configuration array contains configuration objects with the `files` property.

- `files: ["**/*.js"]`: ESM-specific configurations.
- `files: ["**/*.cjs"]`: CommonJS-specific configurations.

### CommonJS projects

In your `eslint.config.js` file, add:

```js
const { defineConfig } = require("eslint/config");
const eslintConfigESLintCJS = require("eslint-config-eslint/cjs");

module.exports = defineConfig([eslintConfigESLintCJS]);
```

### Base config

Note that the above configurations are intended for files that will run in Node.js. For files that will not run in Node.js, you should use the `base` config.

Here's an example of an `eslint.config.js` file for a website project with scripts that run in browser and CommonJS configuration files and tools that run in Node.js:

```js
const { defineConfig } = require("eslint/config");
const eslintConfigESLintBase = require("eslint-config-eslint/base");
const eslintConfigESLintCJS = require("eslint-config-eslint/cjs");

module.exports = defineConfig([
	{
		files: ["scripts/*.js"],
		extends: [eslintConfigESLintBase],
	},
	{
		files: ["eslint.config.js", ".eleventy.js", "tools/*.js"],
		extends: [eslintConfigESLintCJS],
	},
]);
```

### Formatting config

Note that none of the above configurations includes formatting rules. If you want to enable formatting rules, add the formatting config.

```js
import { defineConfig } from "eslint/config";
import eslintConfigESLint from "eslint-config-eslint";
import eslintConfigESLintFormatting from "eslint-config-eslint/formatting";

export default defineConfig([eslintConfigESLint, eslintConfigESLintFormatting]);
```

### Where to ask for help?

Open a [discussion](https://github.com/eslint/eslint/discussions) or stop by our [Discord server](https://eslint.org/chat) instead of filing an issue.

---
_Source: https://npm.io/package/eslint-config-eslint · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
