eslint-plugin-stylelint-2

eslint-plugin-stylelint-2 brings Stylelint reporting and autofix support into ESLint while also adding Stylelint-specific authoring rules for Stylelint config files.

This package exists as eslint-plugin-stylelint-2 on npm because eslint-plugin-stylelint is already taken.

Installation

npm install --save-dev eslint-plugin-stylelint-2 eslint stylelint

Compatibility

• Supported ESLint versions: 9.x and 10.x
• Config system: Flat Config only (eslint.config.*)
• Node.js runtime: >=22.0.0

Quick start

import stylelint2 from "eslint-plugin-stylelint-2";

export default [...stylelint2.configs.recommended];

Presets

Preset	Purpose
stylelint2.configs.recommended	Enable stylesheet linting plus the broadly useful Stylelint config guidance
stylelint2.configs.stylelintOnly	Enable only the Stylelint bridge workflow for stylesheets and ESLint-side autofix
stylelint2.configs.configuration	Enable the full Stylelint config authoring rule catalog, with no stylesheet bridge
stylelint2.configs.all	Enable the stylesheet bridge plus the full config rule catalog

Legacy aliases remain available:

• stylelint2.configs.stylesheets → stylelint2.configs.stylelintOnly
• stylelint2.configs.configs → stylelint2.configs.configuration

Configuration examples

Recommended

import stylelint2 from "eslint-plugin-stylelint-2";

export default [...stylelint2.configs.recommended];

Stylelint bridge only

import stylelint2 from "eslint-plugin-stylelint-2";

export default [stylelint2.configs.stylelintOnly];

Configuration only

import stylelint2 from "eslint-plugin-stylelint-2";

export default [stylelint2.configs.configuration];

That preset notably enables:

• stylelint-2/prefer-stylelint-formatter
• stylelint-2/disallow-stylelint-ignore-disables
• stylelint-2/prefer-stylelint-define-config
• stylelint-2/prefer-stylelint-report-descriptionless-disables
• stylelint-2/prefer-stylelint-report-invalid-scope-disables
• stylelint-2/prefer-stylelint-report-needless-disables
• stylelint-2/prefer-stylelint-report-unscoped-disables

Passing Stylelint options

import stylelint2 from "eslint-plugin-stylelint-2";

export default [
 {
  ...stylelint2.configs.stylelintOnly,
  rules: {
   "stylelint-2/stylelint": [
    "error",
    {
     configFile: "./stylelint.config.mjs",
     customSyntax: "postcss-scss",
    },
   ],
  },
 },
];

Rules

Fix legend:

• 🔧 = autofixable
• — = report only

Preset key legend:

• 🟡 — stylelint2.configs.recommended
• 🎨 — stylelint2.configs.stylelintOnly
• 🔧 — stylelint2.configs.configuration
• 🟣 — stylelint2.configs.all

Rule	Fix	Preset key
stylelint	🔧	🟡 🎨 🟣
disallow-stylelint-allow-empty-input	🔧	🟡 🔧 🟣
disallow-stylelint-configuration-comment	🔧	🟡 🔧 🟣
disallow-stylelint-custom-syntax	🔧	🟡 🔧 🟣
disallow-stylelint-default-severity	🔧	🔧 🟣
disallow-stylelint-duplicate-extends	🔧	🟡 🔧 🟣
disallow-stylelint-duplicate-plugins	🔧	🟡 🔧 🟣
disallow-stylelint-duplicate-rule-option-values	🔧	🟡 🔧 🟣
disallow-stylelint-empty-rules-object	—	🟡 🔧 🟣
disallow-stylelint-ignore-disables	🔧	🔧 🟣
disallow-stylelint-ignore-files	🔧	🔧 🟣
disallow-stylelint-null-rule-config	—	🟡 🔧 🟣
disallow-stylelint-overrides-runtime-options	🔧	🟡 🔧 🟣
disallow-stylelint-processors	🔧	🟡 🔧 🟣
disallow-stylelint-relative-extends-paths	—	🟡 🔧 🟣
disallow-stylelint-relative-plugin-paths	—	🟡 🔧 🟣
prefer-stylelint-cache	🔧	🔧 🟣
prefer-stylelint-define-config	🔧	🟡 🔧 🟣
prefer-stylelint-extends-array	🔧	🟡 🔧 🟣
prefer-stylelint-fix	🔧	🔧 🟣
prefer-stylelint-formatter	—	🔧 🟣
prefer-stylelint-plugins-array	🔧	🟡 🔧 🟣
prefer-stylelint-report-descriptionless-disables	🔧	🟡 🔧 🟣
prefer-stylelint-report-invalid-scope-disables	🔧	🟡 🔧 🟣
prefer-stylelint-report-needless-disables	🔧	🟡 🔧 🟣
prefer-stylelint-report-unscoped-disables	🔧	🟡 🔧 🟣
require-stylelint-custom-syntax-in-overrides	—	🟡 🔧 🟣
require-stylelint-config-file-naming-convention	—	🟡 🔧 🟣
require-stylelint-extends-packages-installed	—	🟡 🔧 🟣
require-stylelint-overrides-configuration	—	🟡 🔧 🟣
require-stylelint-overrides-files-array	—	🟡 🔧 🟣
require-stylelint-overrides-files	—	🟡 🔧 🟣
require-stylelint-plugins-packages-installed	—	🟡 🔧 🟣
require-stylelint-report-disables	🔧	🟡 🔧 🟣
require-stylelint-rules-object	🔧	🟡 🔧 🟣
sort-stylelint-extends	🔧	🟡 🔧 🟣
sort-stylelint-plugins	🔧	🟡 🔧 🟣
sort-stylelint-rule-keys	🔧	🟡 🔧 🟣

Why use this plugin?

Use this plugin when you want ESLint to become the single command and editor integration that reports:

• JavaScript and TypeScript issues
• CSS issues from Stylelint
• Stylelint config authoring issues

This package is strongest when you want repo-level consistency around both stylesheet linting and Stylelint config hygiene.

If your team prefers running Stylelint separately, this package may be unnecessary.

Contributors ✨

See CONTRIBUTORS.md.