ESLint couldn't find the plugin …

Symptoms

When using the legacy ESLint config system, you may see this error running ESLint after installing dependencies:

ESLint couldn't find the plugin "${pluginName}".

(The package "${pluginName}" was not found when loaded as a Node module from the directory "${resolvePluginsRelativeTo}".)

It's likely that the plugin isn't installed correctly. Try reinstalling by running the following:

    npm install ${pluginName}@latest --save-dev

The plugin "${pluginName}" was referenced from the config file in "${importerName}".
1
2
3
4
5
6
7
8
9

Cause

Legacy ESLint configuration files specify shareable configs by their package name. That package name is passed to the Node.js require(), which looks up the package under local node_modules/ directories. For example, the following ESLint config will first try to load a module located at node_modules/eslint-plugin-yours:

module.exports = {
    extends: ["plugin:eslint-plugin-yours/config-name"],
};
1
2
3

If the package is not found in any searched node_modules/, ESLint will print the aforementioned error.

Common reasons for this occurring include:

• Not running npm install or the equivalent package manager command
• Mistyping the case-sensitive name of the plugin

Plugin Name Variations

Note that the eslint-plugin- plugin name prefix may be omitted for brevity, e.g. extends: ["yours"].

@ npm scoped packages put the eslint-plugin- prefix after the org scope, e.g. extends: ["@org/yours"] to load from @org/eslint-plugin-yours.

Resolution

Common resolutions for this issue include:

• Upgrading all versions of all packages to their latest version.
• Adding the plugin as a devDependency in your package.json.
• Running npm install or the equivalent package manager command.
• Checking that the name in your config file matches the name of the plugin package.

Resources

For more information, see:

• Legacy ESLint configuration files for documentation on the legacy ESLint configuration format
• Configure Plugins for documentation on how to extend from plugins
• Create Plugins for documentation on how to define plugins