tailwind-merge

New Features

• Add support for Tailwind CSS v4.0.10 by @dcastil in #546

Bug Fixes

• Fix length variable in via-(length:*) class being merged with via-<color> classes accidentally by @dcastil in #559

Documentation

• Fix typo in comment in types.ts by @roottool in #549
• Update shadow scale recipe to tailwind merge v3 API by @dcastil in #545

Other

• Fix metrics report action erroring on PRs from forks by @dcastil in #551

Full Changelog: v3.0.2...v3.1.0

Thanks to @brandonmcconnell, @manavm1990, @langy, @jamesreaco, @roboflow, @syntaxfm, @getsentry, @codecov, @sourcegraph and a private sponsor for sponsoring tailwind-merge! ❤️

Bug Fixes

• Fix px value not being recognized for some class groups by @dcastil in #538
• Fix doc comment being in incorrect place in default config by @gjtorikian in #526

Full Changelog: v3.0.1...v3.0.2

Thanks to @brandonmcconnell, @manavm1990, @langy, @jamesreaco, @roboflow, @syntaxfm, @getsentry, @codecov, @sourcegraph and a private sponsor for sponsoring tailwind-merge! ❤️

Bug Fixes

• Update info about supported Tailwind CSS version in README by @dcastil in b9c136d
• Update incorrect link in v3 changelog by @dcastil in e22885e

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v3.0.0...v3.0.1

Thanks to @brandonmcconnell, @manavm1990, @langy, @jamesreaco, @roboflow, @syntaxfm, @getsentry, @codecov, @sourcegraph and a private sponsor for sponsoring tailwind-merge! ❤️

Tailwind CSS v4 is here and it's time to upgrade tailwind-merge to support it. tailwind-merge v3.0.0 is more accurate than ever and follows the Tailwind CSS spec more closely than in v2. That is thanks to Tailwind CSS v4 being more consistent than ever.

This release drops support for Tailwind CSS v3 and in turn adds support for Tailwind CSS v4. That means you should upgrade to Tailwind CSS v4 and tailwind-merge v3 together. All breaking changes are related to the Tailwind CSS v4 support.

Check out the migration guide and if you have any questions, feel free to create an issue.

Breaking Changes

• Dropping support for Tailwind CSS v3 in favor of support for Tailwind CSS v4 by @dcastil in https://github.com/dcastil/tailwind-merge/pull/518
• Theme scales keys changed and now match Tailwind CSS v4 theme variable namespace exactly by @dcastil in https://github.com/dcastil/tailwind-merge/pull/518
• isLength validator was removed and split into separate validators isNumber and isFraction by @dcastil in https://github.com/dcastil/tailwind-merge/pull/518
• Prefix defined in config shouldn't include combining - character anymore by @dcastil in https://github.com/dcastil/tailwind-merge/pull/518
• Tailwind CSS v3 prefix position in class not supported anymore in favor of Tailwind CSS v4 position by @dcastil in https://github.com/dcastil/tailwind-merge/pull/518
• Custom separators are no longer supported by @dcastil in https://github.com/dcastil/tailwind-merge/pull/518
• New mandatory orderSensitiveModifiers property in config when using createTailwindMerge by @dcastil in https://github.com/dcastil/tailwind-merge/pull/518
• DefaultThemeGroupIds type union consists of different string literals than before by @dcastil in https://github.com/dcastil/tailwind-merge/pull/518
• Classes removed in Tailwind CSS v4 are not supported by tailwind-merge anymore by @dcastil in https://github.com/dcastil/tailwind-merge/pull/518

New Features

• Support for new important modifier position at the end of class by @dcastil in https://github.com/dcastil/tailwind-merge/pull/518
• Support for arbitrary CSS variable syntax by @dcastil in https://github.com/dcastil/tailwind-merge/pull/518
• There are a bunch of new validators used by tailwind-merge, primarily for new Tailwind CSS v4 features like arbitrary CSS variables by @dcastil in https://github.com/dcastil/tailwind-merge/pull/518

Bug Fixes

• Previously some order-sensitive modifiers like before: were treated as not order-sensitive. This is now fixed by @dcastil in https://github.com/dcastil/tailwind-merge/pull/518

Documentation

• Added section explaining order-sensitive modifiers to configuration docs by @dcastil in https://github.com/dcastil/tailwind-merge/pull/518

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v2.6.0...v3.0.0

Thanks to @brandonmcconnell, @manavm1990, @langy, @jamesreaco, @roboflow, @syntaxfm, @getsentry, @codecov, @sourcegraph and a private sponsor for sponsoring tailwind-merge! ❤️

Bug Fixes

• Fix arbitrary value using color-mix not being detected as color by @dcastil in #591
  • This fix was backported from v3.3.1 to make it available for v2 users.

Full Changelog: v2.6.0...v2.6.1

Thanks to @brandonmcconnell, @manavm1990, @langy, @roboflow, @syntaxfm, @getsentry, @codecov, a private sponsor, @block, @openclaw and more via @thnxdev for sponsoring tailwind-merge! ❤️

New Features

• Export ConfigExtension type from package by @dcastil in https://github.com/dcastil/tailwind-merge/pull/505

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v2.5.5...v2.6.0

Thanks to @brandonmcconnell, @manavm1990, @langy, @jamesreaco, @roboflow, @syntaxfm, @getsentry, @codecov, @sourcegraph, a private sponsor and more via @thnxdev for sponsoring tailwind-merge! ❤️

Bug Fixes

• Fix typo "fractons" instead of "fractions" in "stacked-fractions" class by @oliverhaas in https://github.com/dcastil/tailwind-merge/pull/492

Documentation

• Add installation instructions to configuration docs by @dcastil in https://github.com/dcastil/tailwind-merge/pull/486

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v2.5.4...v2.5.5

Thanks to @brandonmcconnell, @manavm1990, @langy, @jamesreaco, @roboflow, @syntaxfm, @getsentry, @codecov and more via @thnxdev for sponsoring tailwind-merge! ❤️

Bug Fixes

• Fix incorrect paths within sourcemaps by @dcastil in https://github.com/dcastil/tailwind-merge/pull/483

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v2.5.3...v2.5.4

Thanks to @brandonmcconnell, @manavm1990, @langy, @jamesreaco, @roboflow and @codecov for sponsoring tailwind-merge! ❤️