v3.0.1

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: v3.0.0...v3.0.1

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

v3.0.0

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

New Features

• Support for new important modifier position at the end of class by @dcastil in #518
• Support for arbitrary CSS variable syntax by @dcastil in #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 #518

Bug Fixes

• Previously some order-sensitive modifiers like before: were treated as not order-sensitive. This is now fixed by @dcastil in #518

Documentation

• Added section explaining order-sensitive modifiers to configuration docs by @dcastil in #518

Full Changelog: v2.6.0...v3.0.0

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

v2.6.0

New Features

• Export ConfigExtension type from package by @dcastil in #505

Full Changelog: 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! ❤️

v2.5.5

Bug Fixes

• Fix typo "fractons" instead of "fractions" in "stacked-fractions" class by @oliverhaas in #492

Documentation

• Add installation instructions to configuration docs by @dcastil in #486

Full Changelog: v2.5.4...v2.5.5

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

v2.5.4

Bug Fixes

• Fix incorrect paths within sourcemaps by @dcastil in #483

Full Changelog: v2.5.3...v2.5.4

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

v2.5.3

Bug Fixes

• Add missing logical border color properties by @sherlockdoyle in #478

Documentation

• Add benchmark reporting to PRs and commits by @XantreDev in #455

Other

• Switch test suite to vitest by @dcastil in #461

Full Changelog: v2.5.2...v2.5.3

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

v2.5.2

Sorry for all the bugs today!

Bug Fixes

• Fix multiline input not working anymore by @dcastil in #459

Full Changelog: v2.5.1...v2.5.2

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

v2.5.1

Bug Fixes

• Fix space at beginning of input causing infinite loop by @dcastil in #457

Full Changelog: v2.5.0...v2.5.1

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

v2.5.0

New Features

• Performance improvements in mergeClassList by @XantreDev in #450 and @rortan134 in #445
• Use arrow functions where possible to help with minification by @VIKTORVAV99 in #449

Bug Fixes

• Fix bg-opacity arbitrary percentages not being recognized properly by @dcastil in #451

Full Changelog: v2.4.0...v2.5.0

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

v2.4.0

New Features

• Allow hooking into class parsing logic (experimental) by @dcastil in #444
  • There is no info to this in the docs because this is experimental, but there is a new experimentalParseClassName property in the config that allows you to customize how tailwind-merge recognizes classes. If you're interested, you can read how to use it in the inline JSDocs and subscribe to #385 for upcoming more powerful low-level functionality.
• Create security policy by @dcastil in #439
  • Added documentation on how to report potential vulnerabilities
• Avoid @babel/runtime dependency by @dcastil in #431
  • Now no dependencies in tailwind-merge anymore. This dependency was only used in the tailwind-merge/es5 bundle anyway which I don't optimize for.

Documentation

• Comment/typo fixes by @barvian in #443
• Fix typo in doc/recipes.md by @dsernst in #428
• Add tailwind-merge-dotnet to similar packages by @desmondinho in #415

Other

• Added GitHub Action that adds context-v2 label to every issue, discussion and PR by @Pritam1211 in #434
• Replace size-limit action with own metrics-report action by @dcastil in #433

Full Changelog: v2.3.0...v2.4.0

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