Registry / devops / eslint-plugin-import-next

eslint-plugin-import-next

library2.3.6jsnpmunverified

A drop-in replacement for eslint-plugin-import, offering 100x faster no-cycle detection, AI-optimized fixes, and zero-config migration. Current stable version 2.3.6 (released Dec 2025) supports ESLint 8–10. Key differentiator: performance improvements for large codebases, built-in architectural boundary rules, and ESLint v10 compatibility. Ships TypeScript types and presets for various use cases. Not affiliated with the original eslint-plugin-import; migration is mostly automatic but some rule names differ.

devops

npm install eslint-plugin-import-next

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · ESLINT-PLUGIN-IMPO

eslint-plugin-import-next

devopsjavascriptv2.3.6

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

plugin

✓ const plugin = require('eslint-plugin-import-next'); // or import plugin from 'eslint-plugin-import-next'

✗ require('eslint-plugin-import-next').default

Main plugin object is default export; CommonJS require or ESM import works.

rules

✓ import { rules } from 'eslint-plugin-import-next'

✗ const rules = require('eslint-plugin-import-next').rules

ESM named export for rules; also accessible via plugin.rules.

configs

✓ import { configs } from 'eslint-plugin-import-next'

✗ const configs = require('eslint-plugin-import-next').configs

Named export containing all preset configs (recommended, strict, etc.)

Shows how to set up the plugin with ESLint flat config, enabling 'order' and 'no-cycle' rules.

// eslint.config.js (flat config) import importNext from 'eslint-plugin-import-next'; export default [ { plugins: { 'import-next': importNext, }, rules: { 'import-next/order': ['warn', { groups: ['builtin', 'external', 'internal'] }], 'import-next/no-cycle': 'error', }, }, ];

Debug

Known issues

breakingRule names differ from eslint-plugin-import; e.g., 'import/order' becomes 'import-next/order', 'import/no-cycle' becomes 'import-next/no-cycle'.

fix

Update rule names in ESLint config. Use --fix or manual rename.

affects: <2.0.0

breakingDrop-in replacement may require ESLint >=8; older ESLint versions (<8) are not supported from v2 onward.

fix

Upgrade ESLint to v8 or later.

affects: >=2.0.0

gotchaAuto-fix for 'no-cycle' is experimental and may produce incorrect results in circular dependency chains with >3 nodes.

fix

Manually verify fixes; consider setting 'no-cycle' to 'warn' in CI.

affects: <=2.3.6

deprecatedThe 'import-style' preset is deprecated and will be removed in v3; use 'strict' preset instead.

fix

Replace 'import-style' with 'strict' or custom rules.

affects: >=2.0.0 <3.0.0

Errors

Common errors & fixes

Error: Cannot find module 'eslint-plugin-import-next'

Package not installed or missing from node_modules

fix

Run: npm install eslint-plugin-import-next --save-dev

Configuration for rule 'import-next/order' is invalid: invalid schema

Rule options do not match expected schema

fix

Check documentation for correct options; use object literal with groups array.

ESLint configuration error: Rule 'import-next/no-cycle' is not configured

Rule not defined in config but referenced

fix

Ensure the rule is added to rules object after plugin is loaded.

Upgrade

Version history

2.3.6latest on npm

Audit

Dependencies

eslintrequiredpeer dependency; plugin runs as an ESLint plugin

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/ofri-peretz/eslint ↗

packageeslint-plugin-import-next ↗

homepagehttps://github.com/ofri-peretz/eslint/tree/main/packages/eslint-plugin-import-next#readme ↗