What changed in tailwind-merge from 2 to 3
9 releases numbered after v2.6.1 up to and including v3.6.0, stable releases only. v2.6.1 and v3.6.0 are the newest stable releases of 2 and 3 we track; this page follows them as new ones ship.
15 changes across 9 releases
- Add support for Tailwind CSS v4.3
- Add postfixLookupClassGroups option to config to support Tailwind utilities where a slash is part of the full class name, like named container queries
- Add support for readonly array values
- Add support for Tailwind CSS v4.2
- Add support for Tailwind CSS v4.1.5
- Add support for Tailwind CSS v4.1
- Add support for Tailwind CSS v4.0.10
- Make tailwind-merge over 10% faster with performance optimizations
- Fix broken links in README
- Prevent arbitrary font-family and font-weight from merging
- Fix arbitrary value using color-mix() not being detected as color
- Fix length variable in via-(length:*) class being merged with via-<color> classes accidentally
- Fix px value not being recognized for some class groups
- Fix doc comment being in incorrect place in default config
- Harden internal CI pipeline security by omitting git checkout
Original release notes, newest first
The list above is our reading of these notes; the originals from Dany Castillo are here, one fold per release.
v3.6.0
New Features
- Add support for Tailwind CSS v4.3 by @dcastil in https://github.com/dcastil/tailwind-merge/pull/677
- Add
postfixLookupClassGroupsoption to config to support Tailwind utilities where a slash is part of the full class name, like named container queries
- Add
- Add support for readonly array values by @unional in https://github.com/dcastil/tailwind-merge/pull/652
Documentation
- Fix broken links in README by @maurer2 in https://github.com/dcastil/tailwind-merge/pull/662
Other
- Harden internal CI pipeline security by omitting git checkout by @dcastil, suggested by @kyletaylored in https://github.com/dcastil/tailwind-merge/commit/6b2499c10cf52bed42426d30b4219e90374b30d6
Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v3.5.0...v3.6.0
Thanks to @brandonmcconnell, @manavm1990, @langy, @roboflow, @syntaxfm, @getsentry, @codecov, a private sponsor, @block, @openclaw, @sourcegraph, @mike-healy and more via @thnxdev for sponsoring tailwind-merge! ❤️
v3.5.0
New Features
- Add support for Tailwind CSS v4.2 by @dcastil in https://github.com/dcastil/tailwind-merge/pull/651
Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v3.4.1...v3.5.0
Thanks to @brandonmcconnell, @manavm1990, @langy, @roboflow, @syntaxfm, @getsentry, @codecov, a private sponsor, @block, @openclaw, @sourcegraph and more via @thnxdev for sponsoring tailwind-merge! ❤️
v3.4.1
Bug Fixes
- Prevent arbitrary font-family and font-weight from merging by @roneymoon in https://github.com/dcastil/tailwind-merge/pull/635
Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v3.4.0...v3.4.1
Thanks to @brandonmcconnell, @manavm1990, @langy, @roboflow, @syntaxfm, @getsentry, @codecov, a private sponsor, @block, @openclaw, @sourcegraph and more via @thnxdev for sponsoring tailwind-merge! ❤️
v3.4.0
New Features
- Performance optimizations which make tailwind-merge >10% faster
- Vibe optimization by @quantizor in https://github.com/dcastil/tailwind-merge/pull/547
- Additional optimizations by @quantizor in https://github.com/dcastil/tailwind-merge/pull/619
Documentation
- Improve docs by clarifying things, adding more examples by @dcastil in https://github.com/dcastil/tailwind-merge/pull/618
- Make examples more realistic by @dcastil in https://github.com/dcastil/tailwind-merge/pull/617
- Add custom variant as an alternative to docs by @kidonng in https://github.com/dcastil/tailwind-merge/pull/592
Other
- Improve benchmarking suite by @quantizor in https://github.com/dcastil/tailwind-merge/pull/620
Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v3.3.1...v3.4.0
Thanks to @brandonmcconnell, @manavm1990, @langy, @roboflow, @syntaxfm, @getsentry, @codecov and a private sponsor for sponsoring tailwind-merge! ❤️
v3.3.1
Bug Fixes
- Fix arbitrary value using
color-mix()not being detected as color by @dcastil in https://github.com/dcastil/tailwind-merge/pull/591
Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v3.3.0...v3.3.1
Thanks to @brandonmcconnell, @manavm1990, @langy, @roboflow, @syntaxfm, @getsentry, @codecov, @sourcegraph, a private sponsor, @block and @shawt3000 for sponsoring tailwind-merge! ❤️
v3.3.0
New Features
- Add support for tailwind CSS v4.1.5 by @dcastil in https://github.com/dcastil/tailwind-merge/pull/575
Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v3.2.0...v3.3.0
Thanks to @brandonmcconnell, @manavm1990, @langy, @roboflow, @syntaxfm, @getsentry, @codecov, @sourcegraph, a private sponsor and @block for sponsoring tailwind-merge! ❤️
v3.2.0
New Features
- Add support for Tailwind CSS v4.1 by @dcastil in https://github.com/dcastil/tailwind-merge/pull/565
Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v3.1.0...v3.2.0
Thanks to @brandonmcconnell, @manavm1990, @langy, @jamesreaco, @roboflow, @syntaxfm, @getsentry, @codecov, @sourcegraph and a private sponsor for sponsoring tailwind-merge! ❤️
v3.1.0
New Features
- Add support for Tailwind CSS v4.0.10 by @dcastil in https://github.com/dcastil/tailwind-merge/pull/546
Bug Fixes
- Fix length variable in
via-(length:*)class being merged withvia-<color>classes accidentally by @dcastil in https://github.com/dcastil/tailwind-merge/pull/559
Documentation
- Fix typo in comment in types.ts by @roottool in https://github.com/dcastil/tailwind-merge/pull/549
- Update shadow scale recipe to tailwind merge v3 API by @dcastil in https://github.com/dcastil/tailwind-merge/pull/545
Other
- Fix metrics report action erroring on PRs from forks by @dcastil in https://github.com/dcastil/tailwind-merge/pull/551
Full Changelog: https://github.com/dcastil/tailwind-merge/compare/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! ❤️
v3.0.2
Bug Fixes
- Fix
pxvalue not being recognized for some class groups by @dcastil in https://github.com/dcastil/tailwind-merge/pull/538 - Fix doc comment being in incorrect place in default config by @gjtorikian in https://github.com/dcastil/tailwind-merge/pull/526
Full Changelog: https://github.com/dcastil/tailwind-merge/compare/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! ❤️