@eslint/create-config

Utility to create ESLint config files

Usage

Prerequisites: Node.js (^18.18.0, ^20.9.0, or >=21.1.0) built with SSL support. (If you are using an official Node.js distribution, SSL is always built in.)

You can use npm/npx(shipped with Node.js).

# use npm
npm init @eslint/config@latest

# use npx
npx @eslint/create-config@latest

If you want to use a specific shareable config that is hosted on npm, you can use the --config option and specify the package name:

# use `eslint-config-standard` shared config
npm init @eslint/config@latest -- --config eslint-config-standard

To use an eslintrc-style (legacy) shared config:

npm init @eslint/config@latest -- --eslintrc --config eslint-config-standard

Sponsors

The following companies, organizations, and individuals support ESLint's ongoing maintenance and development. Become a Sponsor to get your logo on our READMEs and website.

Platinum Sponsors

Gold Sponsors

Silver Sponsors

Bronze Sponsors

Technology Sponsors

Changelog

1.11.0 (2025-10-27)

Features

• improve shareable config (#208) (3fccf98)
• update ui (#202) (cf7f3e0)

Bug Fixes

• exit gracefully on Ctrl+C (#194) (2127040)

1.10.0 (2025-07-21)

Features

• add TypeScript config file support (#181) (04935f1)

Bug Fixes

• remove double blank lines when not use eslintrc style (#185) (c2de1f7)

1.9.0 (2025-05-20)

Features

• add support for .mts and .cts extensions (#173) (81ca6e1)

1.8.3 (2025-05-14)

Bug Fixes

• ensure posix-compliant newline at end of generated configs (#170) (8f18045)

1.8.2 (2025-05-07)

Bug Fixes

• semver calculations for defineConfig import (#168) (7b7f831)

1.8.1 (2025-04-14)

Bug Fixes

• use correct import path for semver (#165) (ef6fa23)

1.8.0 (2025-04-09)

Features

• add fallback to npm registry API in fetchPeerDependencies (#155) (d08a7a4)

Bug Fixes

• correct defineConfig usage in generated config (#161) (dfef597)

1.7.0 (2025-03-31)

Features

• support languages json/markdown/css (#159) (886f39e)

1.6.0 (2025-03-20)

Features

• Output defineConfig in file (#156) (f607c76)

1.5.0 (2025-02-12)

Features

• avoid empty config warning (#153) (2a75349)

1.4.0 (2024-10-25)

Features

• add types for the configuration's default export (#147) (2eaacd0)

1.3.1 (2024-08-13)

Bug Fixes

• re-trigger release-please (#145) (6fbb932)

1.3.0 (2024-08-04)

Features

• typescript-eslint v8 has supported eslint v9 (#141) (f8d9c30)

1.2.0 (2024-07-22)

Features

• eslint-plugin-react supports ESLint v9 (#139) (359cf50)

1.1.6 (2024-07-12)

Bug Fixes

• Add custom ts parser for vue projects (#136) (0098452)

1.1.5 (2024-06-19)

Bug Fixes

• add files globs to be linted (#130) (19d7d6f)
• add warning message for ESLint v9 with npm --force flag (#132) (f8178a8)

1.1.4 (2024-06-10)

Bug Fixes

• enable linting .jsx files when React is selected (#126) (6736f3d)

1.1.3 (2024-06-04)

Bug Fixes

• do not use --force when choosing yarn/eslint v8 (#123) (b377ad7)

1.1.2 (2024-05-26)

Bug Fixes

• use --force to install eslint v9 + tseslint (#118) (27a207e)

1.1.1 (2024-05-17)

Bug Fixes

• use @eslint/compat to fix eslint v9 + react plugin (#113) (61a385e)

1.1.0 (2024-04-28)

Features

• remove style guides (#108) (de1d085)

Chores

• run tests in Node.js 22 (#109) (b2320d8)

1.0.3 (2024-04-22)

Documentation

• use @eslint/create-config latest (#103) (8366a9e)

1.0.2 (2024-04-16)

Bug Fixes

• not install multi tseslint versions (#94) (ba1a02c)

1.0.1 (2024-04-10)

Bug Fixes

• use eslint-config-airbnb-base by default (#92) (627306a), closes #87

Chores

• run npm install before npm publish (#88) (136df22)

1.0.0 (2024-04-05)

⚠ BREAKING CHANGES

• support flat config (#81)
• Require Node.js ^18.18.0 || ^20.9.0 || >=21.1.0 (#80)

Features

• add bun package manager (#78) (903f929)
• Require Node.js ^18.18.0 || ^20.9.0 || >=21.1.0 (#80) (f893814)
• support flat config (#81) (54ac1f2)

Bug Fixes

• add log.warn (#85) (3749cd6)
• Remove Google style guide (#82) (9c4214b), closes #75

Chores

• run tests in Node.js 21 (#76) (bd20976)
• run tests on all supported versions of Node.js (#77) (f7da13a)
• standardize npm script names (#69) (38d293a)
• switch to eslint flat config (#73) (4bde28a)

0.4.6 (2023-07-24)

Chores

• generate provenance statements when release (#67) (99488cf)

0.4.5 (2023-06-16)

Bug Fixes

• add cjs override for esm projects (fixes #59) (#63) (2568629)

Chores

• trigger release-please (#65) (6c0e7a1)

0.4.4 (2023-06-01)

Bug Fixes

• generated vue-ts config (#64) (0be55af)

Chores

• run tests on Node.js v20 (#60) (72ffdcd)
• Update tweet message (#61) (e956b80)

0.4.3 (2023-04-09)

Documentation

• remove extra custom anchor (#52) (c486ddf)
• sync --config examples with ESLint Getting Started docs (#55) (4e48315)

Chores

• add triage action (#50) (81d7730)
• Also post releases to Mastodon (#56) (9fc2de4)
• include all commits in the changelog (#57) (6f6308a)
• set up release-please (#54) (5216efa)
• use LTS node version in lint job (#53) (a0d54a1)

v0.4.2 - December 30, 2022

• 561970e docs: sync --config instructions in README with eslint Getting Started (#45) (Milos Djermanovic)
• 66cc96c ci: add Node v19 (#44) (Milos Djermanovic)

v0.4.1 - October 31, 2022

• d42d866 docs: update --config usage for npm v7+ (#42) (唯然)

v0.4.0 - October 21, 2022

• a0fa620 feat: support --config (#38) (Percy Ma)
• 368a1a3 chore: Remove unused code (#36) (Brandon Mills)

v0.3.1 - August 13, 2022

• bf2a259 fix: remove airbnb/google in style guides when using ts (#33) (唯然)

v0.3.0 - July 1, 2022

• f446191 feat: support vue3 (#34) (唯然)

v0.2.0 - May 4, 2022

• 3c6197b build: add node v18 (#29) (唯然)
• dbd5e34 fix: throw error and exit when package.json not found (#27) (Strek)
• 8a26ef4 feat: added yarn and pnpm installations (#24) (Strek)
• a9841e2 chore: upgrade esmock (#26) (唯然)

v0.1.2 - January 7, 2022

• c8ba806 fix: Wrong info about globally-installed copy of ESLint (#18) (唯然)
• da0fcbb fix: cannot find installed eslint (#15) (唯然)
• 859b379 fix: missing question to confirm installing dependencies (#14) (唯然)

v0.1.1 - December 17, 2021

• 48d8025 fix: import("eslint") doesn't work (#9) (唯然)

v0.1.0 - December 15, 2021

• 6d20aa3 chore: add publishConfig field in package.json (#6) (Nitin Kumar)
• 5cb3a94 fix: upgrade esmock v1.7.0 (#5) (唯然)
• bd6eb01 ci: use node v16 (#3) (Nitin Kumar)
• d054ce7 feat: move eslint --init (#1) (唯然)
• f90b605 Initial commit (Nicholas C. Zakas)