eslint-plugin-import-helpers

Originally forked/inspired by eslint-plugin-import and this fork

This package was created to supplement the rules provided by eslint-plugin-import. There are a lot of great rules in there, but we found it missing a few key use cases.

Alternatives

[!TIP] Use Prettier!

I recommend using @ianvs/prettier-plugin-sort-imports instead of this ESLint plugin for sorting imports. It works really well and I think Prettier is better suited for formatting-related rules.

Rules

order-imports

Enforce a configurable convention in module import order. See the order-imports page for configuration details.

1// Given ESLint Config
2rules: {
3  'import-helpers/order-imports': [
4      'warn',
5      {
6          newlinesBetween: 'always', // new line between groups
7          groups: [
8              'module',
9              '/^@shared/',
10              ['parent', 'sibling', 'index'],
11          ],
12          alphabetize: { order: 'asc', ignoreCase: true },
13      },
14  ],
15}
16
17// will fix
18import SiblingComponent from './SiblingComponent';
19import lodash from 'lodash';
20import SharedComponent from '@shared/components/SharedComponent';
21import React from 'react';
22
23// into
24import lodash from 'lodash';
25import React from 'react';
26
27import SharedComponent from '@shared/components/SharedComponent';
28
29import SiblingComponent from './SiblingComponent';

Installation

1npm install eslint-plugin-import-helpers -g

or if you manage ESLint as a dev dependency:

1# inside your project's working tree
2npm install eslint-plugin-import-helpers --save-dev

To add a rule, update your .eslintrc.(yml|json|js):

1{
2    // .eslintrc.js
3    plugins: ['eslint-plugin-import-helpers'],
4    rules: {
5        'import-helpers/order-imports': [
6            'warn',
7            { // example configuration
8                newlinesBetween: 'always',
9                groups: [
10                    'module',
11                    '/^@shared/',
12                    ['parent', 'sibling', 'index'],
13                ],
14                alphabetize: { order: 'asc', ignoreCase: true },
15            },
16        ],
17    }
18}

ESLint Versions

The 2.0 version supports ESLint v9. It may still work with older versions of ESLint but we no longer test against it. If you need ESLint v8 support, use 1.X.

TypeScript

To use this plugin with TypeScript, you must use the TypeScript parser for ESLint. See @typescript-eslint/parser for more details.

Please note that the import sorter does not currently work with type imports.

Working with This Repo

Dependencies

Name	Version
node.js	22.x

Running Tests

First, npm install Then, npm test