Skip to main content
Version: v5

Migration Guide

This migration guide will help you to use the latest version of the config.

ESLint v9 introduced the flat config file, so a separate package, @nish1896/eslint-flat-config, was created from @nish1896/eslint-config with the same set of rules. The latest major version of this package is built for ESLint v10.

Which package and version should I use?​

ESLint versionPackageVersion
8.57.1 or below@nish1896/eslint-config3.x (deprecated, no further updates)
9@nish1896/eslint-flat-config3.x (deprecated, see the ESLint 9 usage guide)
10 and above@nish1896/eslint-flat-config4.x and above

The legacy ESLint v8 configuration is only supported till version 3 of @nish1896/eslint-config.

Migration guides​

Pick the guide that matches where you are coming from:

  • ESLint 8 to 9: Migrate to eslint v9, switch from @nish1896/eslint-config to @nish1896/eslint-flat-config.
  • ESLint 9 to 10: Migrate from v3 to v4, upgrade @nish1896/eslint-flat-config for ESLint v10. This needs Node.js ^20.19.0 || ^22.13.0 || >=24.
  • Older releases of @nish1896/eslint-flat-config: v2 to v3 and v1 to v2.

If you are on ESLint 8, go through the ESLint 8 to 9 guide first, then the v3 to v4 guide.

About @stylistic/eslint-plugin​

@stylistic/eslint-plugin is used by both packages for the formatting rules. Its language-specific plugins (@stylistic/eslint-plugin-js, -ts, -jsx and -plus) are deprecated and merged back into the single plugin since its v5. @nish1896/eslint-flat-config uses the unified plugin, see the v2 to v3 guide.