Getting Started with eslint-plugin-import-next

#javascript #eslint #imports #tutorial

Up to 100x faster than eslint-plugin-import. Flat config native. Bundle optimization included.

🔄 Drop-in replacement — 100% compatible with all eslint-plugin-import rules, but faster, LLM-optimized error messages, and fewer false positives/negatives.

Quick Install

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

Flat Config

// eslint.config.js
import importNext from 'eslint-plugin-import-next';

export default [importNext.configs.recommended];

Run ESLint

npx eslint .

Performance

Benchmark	Speedup
Core Rules (9 rules)	5.2x faster
Recommended Preset	5.5x faster
`no-cycle` Rule Only	100x faster 🔥

Tested on 5,000-10,000 files. Full benchmark methodology →

📊 See the full benchmark comparison →

Available Presets

// Full compatibility with eslint-plugin-import
importNext.configs.recommended;

// TypeScript-optimized
importNext.configs.typescript;

// Bundle size optimization
importNext.configs.performance;

// Enterprise governance
importNext.configs.enterprise;

Rule Categories

Category	Rules	Examples
Static Analysis	15	no-unresolved, named, namespace
Module Systems	8	no-commonjs, no-amd, unambiguous
Style Guide	10	order, newline-after-import, first
Bundle Optimization	5	no-barrel-file, prefer-direct-import
Enterprise	3	enforce-team-boundaries, no-legacy-imports

Migration from eslint-plugin-import

# Remove old plugin
npm uninstall eslint-plugin-import eslint-import-resolver-typescript

# Install new plugin
npm install --save-dev eslint-plugin-import-next

// Update config
// Before:
import importPlugin from 'eslint-plugin-import';
export default [importPlugin.configs.recommended];

// After:
import importNext from 'eslint-plugin-import-next';
export default [importNext.configs.recommended];

Quick Reference

# Install
npm install --save-dev eslint-plugin-import-next

# Config (eslint.config.js)
import importNext from 'eslint-plugin-import-next';
export default [importNext.configs.recommended];

# Run
npx eslint .