# @eslint/eslintrc
> The legacy ESLintRC config file format for ESLint
Latest version **3.3.7** (published 2026-09-01) · MIT license · 0 weekly downloads
## Install
```sh
npm install @eslint/eslintrc
pnpm add @eslint/eslintrc
yarn add @eslint/eslintrc
bun add @eslint/eslintrc
```
## Health
**Score 75/100 (B)** — status: active.
Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.
Warnings: low downloads.
## Facts
| | |
|---|---|
| Version | 3.3.7 |
| Published | 2026-09-01 |
| First published | 2020-08-24 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | ^18.18.0 \|\| ^20.9.0 \|\| >=21.1.0 |
| Dependencies | 9 |
| Unpacked size | 678.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| Author | Nicholas C. Zakas |
| Maintainers | openjsfoundation, eslintbot |
| Keywords | ESLint, ESLintRC, Configuration |
## Links
- npm: https://www.npmjs.com/package/@eslint/eslintrc
- Repository: https://github.com/eslint/eslintrc
- Homepage: https://github.com/eslint/eslintrc#readme
- Issues: https://github.com/eslint/eslintrc/issues
- Funding: https://opencollective.com/eslint
- npm.io page: https://npm.io/package/@eslint/eslintrc
## Dependencies (9)
- [ajv](https://npm.io/package/ajv.md) ^6.14.0
- [debug](https://npm.io/package/debug.md) ^4.3.2
- [espree](https://npm.io/package/espree.md) ^10.0.1
- [ignore](https://npm.io/package/ignore.md) ^5.2.0
- [globals](https://npm.io/package/globals.md) ^14.0.0
- [js-yaml](https://npm.io/package/js-yaml.md) ^4.3.2
- [minimatch](https://npm.io/package/minimatch.md) ^3.1.5
- [import-fresh](https://npm.io/package/import-fresh.md) ^3.2.1
- [strip-json-comments](https://npm.io/package/strip-json-comments.md) ^3.1.1
## Alternatives
- [jsforce](https://npm.io/package/jsforce.md) — 851.2K weekly downloads
- [react-native-qrcode-svg](https://npm.io/package/react-native-qrcode-svg.md) — 693.5K weekly downloads
- [@salesforce/plugin-data](https://npm.io/package/@salesforce/plugin-data.md) — 394.9K weekly downloads
- [@backstage/plugin-search-common](https://npm.io/package/@backstage/plugin-search-common.md) — 308.5K weekly downloads
- [@chain-registry/types](https://npm.io/package/@chain-registry/types.md) — 38.4K weekly downloads
## Recent versions
- 3.3.7 (latest) — 2026-09-01
- 3.3.6 — 2026-07-10
- 3.3.5 — 2026-03-06
- 3.3.4 — 2026-02-23
- 3.3.3 — 2025-11-28
- 3.3.1 — 2025-03-21
- 3.3.0 — 2025-02-21
- 3.2.0 — 2024-11-15
- 3.1.0 — 2024-05-17
- 3.0.2 — 2024-02-23
- 3.0.1 — 2024-02-09
- 3.0.0 — 2023-12-27
- 2.1.4 — 2023-12-01
- 2.1.3 — 2023-11-03
- 2.1.2 — 2023-08-11
- … 36 more at https://npm.io/package/@eslint/eslintrc/versions
## README
# ESLintRC Library
This repository contains the legacy ESLintRC configuration file format for ESLint. This package is not intended for use outside of the ESLint ecosystem. It is ESLint-specific and not intended for use in other programs.
**Note:** This package is frozen except for critical bug fixes as ESLint moves to a new config system.
## Installation
You can install the package as follows:
```shell
npm install @eslint/eslintrc -D
# or
yarn add @eslint/eslintrc -D
# or
pnpm install @eslint/eslintrc -D
# or
bun install @eslint/eslintrc -D
```
## Usage (ESM)
The primary class in this package is `FlatCompat`, which is a utility to translate ESLintRC-style configs into flat configs. Here's how you use it inside of your `eslint.config.js` file:
```js
import { FlatCompat } from "@eslint/eslintrc";
import js from "@eslint/js";
import path from "path";
import { fileURLToPath } from "url";
// mimic CommonJS variables -- not needed if using CommonJS
const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
const compat = new FlatCompat({
baseDirectory: __dirname, // optional; default: process.cwd()
resolvePluginsRelativeTo: __dirname, // optional
recommendedConfig: js.configs.recommended, // optional unless you're using "eslint:recommended"
allConfig: js.configs.all, // optional unless you're using "eslint:all"
});
export default [
// mimic ESLintRC-style extends
...compat.extends("standard", "example", "plugin:react/recommended"),
// mimic environments
...compat.env({
es2020: true,
node: true
}),
// mimic plugins
...compat.plugins("jsx-a11y", "react"),
// translate an entire config
...compat.config({
plugins: ["jsx-a11y", "react"],
extends: "standard",
env: {
es2020: true,
node: true
},
rules: {
semi: "error"
}
})
];
```
## Usage (CommonJS)
Using `FlatCompat` in CommonJS files is similar to ESM, but you'll use `require()` and `module.exports` instead of `import` and `export`. Here's how you use it inside of your `eslint.config.js` CommonJS file:
```js
const { FlatCompat } = require("@eslint/eslintrc");
const js = require("@eslint/js");
const compat = new FlatCompat({
baseDirectory: __dirname, // optional; default: process.cwd()
resolvePluginsRelativeTo: __dirname, // optional
recommendedConfig: js.configs.recommended, // optional unless using "eslint:recommended"
allConfig: js.configs.all, // optional unless using "eslint:all"
});
module.exports = [
// mimic ESLintRC-style extends
...compat.extends("standard", "example", "plugin:react/recommended"),
// mimic environments
...compat.env({
es2020: true,
node: true
}),
// mimic plugins
...compat.plugins("jsx-a11y", "react"),
// translate an entire config
...compat.config({
plugins: ["jsx-a11y", "react"],
extends: "standard",
env: {
es2020: true,
node: true
},
rules: {
semi: "error"
}
})
];
```
## Troubleshooting
**TypeError: Missing parameter 'recommendedConfig' in FlatCompat constructor**
The `recommendedConfig` option is required when any config uses `eslint:recommended`, including any config in an `extends` clause. To fix this, follow the example above using `@eslint/js` to provide the `eslint:recommended` config.
**TypeError: Missing parameter 'allConfig' in FlatCompat constructor**
The `allConfig` option is required when any config uses `eslint:all`, including any config in an `extends` clause. To fix this, follow the example above using `@eslint/js` to provide the `eslint:all` config.
## License
MIT License
## Sponsors
The following companies, organizations, and individuals support ESLint's ongoing maintenance and development. [Become a Sponsor](https://eslint.org/donate)
to get your logo on our READMEs and [website](https://eslint.org/sponsors).
Platinum Sponsors
Gold Sponsors
Silver Sponsors
Bronze Sponsors
Technology Sponsors
Technology sponsors allow us to use their products and services for free as part of a contribution to the open source ecosystem and our work.
---
_Source: https://npm.io/package/@eslint/eslintrc · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._