eslint-plugin-path weekly downloads statistics

eslint-plugin-path

An ESLint plugin for enforcing consistent import paths across a project. It rewrites relative imports to absolute ones (or the reverse), based on the paths and baseUrl in your tsconfig.json / jsconfig.json.

Installation

ESLint 10+

This plugin requires ESLint 10 or later and Node.js ^20.19.0 || ^22.13.0 || >=24 — the same range ESLint 10 supports.

It uses the flat config format (eslint.config.js). The legacy .eslintrc format was removed in ESLint 10 and is not supported.

Basic usage

Using defineConfig()

Using presets

Custom tsconfig/jsconfig paths

If you are using custom paths in your tsconfig.json or jsconfig.json file, you can specify the path to the configuration file in your ESLint settings:

Configuration

Enable the rules in your ESLint flat configuration:

Or use the recommended preset:

What is checked

All three rules inspect the specifier of these forms:

Re-export declarations are not checked:

Bare specifiers that resolve inside node_modules (e.g. react) are always skipped.

Rules

✔ included in the "recommended" preset

🔧 fixable using the --fix command line option

💡 provides editor suggestions

| | | | Name | Description |

| ✔ | 🔧 | 💡 | no-relative-imports | disallow relative imports of files where absolute is preferred | | | 🔧 | 💡 | no-absolute-imports | disallow absolute imports of files where relative is preferred | | | 🔧 | 💡 | only-absolute-imports |disallow relative imports of files through the whole project |

Presets

• recommended — enables no-relative-imports with { maxDepth: 1, suggested: true }. Note this is stricter than the rule's own defaults ({ maxDepth: 2, suggested: false }).

recommended is the only preset. The three rules express mutually exclusive policies, so no single config can enable them together — pick the one rule that matches your project and configure it explicitly.

Removed in 3.0.0: the all preset. It never enabled all rules — it enabled only no-relative-imports, with weaker settings than recommended. See the CHANGELOG.

License

MIT

Description from the npm listing.