npm / eslint-plugin-tailwindcss
eslint-plugin-tailwindcss
What changed in eslint-plugin-tailwindcss 4, from its official release notes, upgrade guides and advisories. Also covers @types/eslint-plugin-tailwindcss. Sources checked 2026-10-19.
3 breaking2 new APIs and options1 performance2 behavior and defaults1 tooling5 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initeslint-plugin-tailwindcss 414 changes
Breaking changes 3
Version 4 of eslint-plugin-tailwindcss is only compatible with the ESLint flat config format.
Version 4 of eslint-plugin-tailwindcss requires Node >= 20.19.0.
Version 4 of eslint-plugin-tailwindcss is only compatible with Tailwind CSS v4.x.x.
New APIs and options 2
Adds the enforces-canonical-classname rule, available only with Tailwind CSS v4.3.0 or above.
Adds a rule that ensures the ! important modifier is at the end of class names; its former position between modifiers and the class name is deprecated.
Performance 1
Linting is faster.
Behavior and default changes 2
Enhanced support for Svelte class attributes, directives, and expressions, including conditional classes and class values from props.
The rule now detects redundant arbitrary values by resolving unit conversions and spacing configurations, and suggests native Tailwind alternatives.
Tooling 1
Adds support for the satisfies operator in TypeScript.
Fixes and other changes 5
Adds import.meta.url to paths in TailwindUtils.
The fixers now respect optional ! important modifiers.
Fixes false positives involving border and divide classes in this rule.
Fixes the rule so it works when prefixed.
Adds the missing eslint peer dependency.