Tailwind Merge Versions Save

New Features

• Add support for mix-blend-plus-darker utility by @dcastil in https://github.com/dcastil/tailwind-merge/pull/403
• Added support for bigint in ClassNameValue type by @LarsArtmann in https://github.com/dcastil/tailwind-merge/pull/402

Documentation

• Add tailwind-merge-go to similar packages in docs by @Oudwins in https://github.com/dcastil/tailwind-merge/pull/396

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v2.2.2...v2.3.0

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

Bug Fixes

• Fix arbitrary shadow with inset not recognized by @dcastil in https://github.com/dcastil/tailwind-merge/pull/392

Documentation

• Fix minor typos in configuration.md by @stephan281094 in https://github.com/dcastil/tailwind-merge/pull/372

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v2.2.1...v2.2.2

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

Bug Fixes

• Fix stroke-color being incorrectly detected as stroke-width by @dcastil in https://github.com/dcastil/tailwind-merge/pull/371

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v2.2.0...v2.2.1

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

New Features

• Add support for Tailwind CSS v3.4 by @dcastil in https://github.com/dcastil/tailwind-merge/pull/360

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v2.1.0...v2.2.0

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

New Features

• Add ClassValidator type to package exports by @dcastil in https://github.com/dcastil/tailwind-merge/pull/348

Bug Fixes

• Fix display class not removed when it precedes line-clamp class by @dcastil in https://github.com/dcastil/tailwind-merge/pull/347

Documentation

• Fix curly bracket typo in config docs by @Kosai106 in https://github.com/dcastil/tailwind-merge/pull/349

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

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

The tailwind-merge v2 release has been sitting here almost finished for 2 months already. But the timing was never quite right, especially thinking about the increased support needed after the release. In the meantime, the product of the company I work at launched in public beta and I married. Thank you for your patience.

This release focuses on making it easier to configure the library for new users. Check out the migration guide and if you have any questions, feel free to create an issue.

Breaking Changes

• Fix background-image and background-position being merged incorrectly by @dcastil in https://github.com/dcastil/tailwind-merge/pull/300
  • Values for background-position and background-size can look very similar and Tailwind CSS uses the same bg- prefix for both groups. This results in some limitations for tailwind-merge. If you use background position or background size with arbitrary values, please read this section about how to use them.
• Make types of available keys more strict and configurable through generics by @kachkaev in https://github.com/dcastil/tailwind-merge/pull/279
• Make it possible to override elements with extendTailwindMerge by @dcastil in https://github.com/dcastil/tailwind-merge/pull/294
• Separate validators better by @dcastil in https://github.com/dcastil/tailwind-merge/pull/292
• Make conflictingClassGroupModifiers in config non-optional by @dcastil in https://github.com/dcastil/tailwind-merge/pull/291
• Move separator to config by @dcastil in https://github.com/dcastil/tailwind-merge/pull/290
• Remove module field from package.json by @dcastil in https://github.com/dcastil/tailwind-merge/pull/289
• Remove deprecated exports by @dcastil in https://github.com/dcastil/tailwind-merge/pull/288
• Transpile lib to more modern JS by @dcastil in https://github.com/dcastil/tailwind-merge/pull/287

New Features

• Make types of available keys more strict and configurable through generics by @kachkaev in https://github.com/dcastil/tailwind-merge/pull/279
• Make it possible to override elements with extendTailwindMerge by @dcastil in https://github.com/dcastil/tailwind-merge/pull/294
• Separate validators better by @dcastil in https://github.com/dcastil/tailwind-merge/pull/292
• Make conflictingClassGroupModifiers in config non-optional by @dcastil in https://github.com/dcastil/tailwind-merge/pull/291
• Move separator to config by @dcastil in https://github.com/dcastil/tailwind-merge/pull/290
• Remove module field from package.json by @dcastil in https://github.com/dcastil/tailwind-merge/pull/289
• Remove deprecated exports by @dcastil in https://github.com/dcastil/tailwind-merge/pull/288
• Transpile lib to more modern JS by @dcastil in https://github.com/dcastil/tailwind-merge/pull/287
• Add ES5 bundle by @dcastil in https://github.com/dcastil/tailwind-merge/pull/286

Bug Fixes

• Fix touch action classes overriding each other incorrectly by @dcastil in https://github.com/dcastil/tailwind-merge/pull/313
• Fix background-image and background-position being merged incorrectly by @dcastil in https://github.com/dcastil/tailwind-merge/pull/300
• Fix number validators accidentally returning true for empty strings by @dcastil in https://github.com/dcastil/tailwind-merge/pull/295
• Rename lazy-initializaton.test.ts to lazy-initialization.test.ts by @CrutchTheClutch in https://github.com/dcastil/tailwind-merge/pull/284

Documentation

• Explain limitations of arbitrary values in bg-size and bg-position class groups in docs by @dcastil in https://github.com/dcastil/tailwind-merge/pull/328

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v1.14.0...v2.0.0

Thanks to @quezlatch, @brandonmcconnell, @manavm1990 and @ErwinAI for sponsoring tailwind-merge! ❤️

New Features

• Improve support for arbitrary values by @dcastil in https://github.com/dcastil/tailwind-merge/pull/263
  • Previously, tailwind-merge checked the content of the arbitrary value portion of a class in most cases to understand whether the type of the arbitrary value is correct (e.g. it checked for number followed by length unit for the length type). That lead to the issue that a class like mt-[calc(theme(fontSize.4xl)/1.125)] would not be recognized correctly because no length unit is present in the arbitrary value.
  • I changed the check of the arbitrary value to also pass when a calc(), min(), max() and clamp() function is used in the arbitrary value.
  • In ambiguous cases, you can use data type labels to mark the type of a class. Read more
  • Moreover, I removed the check where the type of the arbitrary value is unambiguous. In the class mt-[…] the arbitrary value can only be a length, so I don't check for it. A consequence of this is that if you use non-Tailwind classes like mt-[this-is-totally-not-tailwind], tailwind-merge will recognize it as a Tailwind class from now on. Please don't use classes that look like Tailwind classes with arbitrary value but aren't Tailwind classes with tailwind-merge (in default config) to prevent incorrect merging behavior.

Bug Fixes

• Fix col-span-full class missing in default config by @dcastil in https://github.com/dcastil/tailwind-merge/pull/267
• Fix arbitrary value with no present length unit not being recognized by @dcastil in https://github.com/dcastil/tailwind-merge/pull/263

Documentation

• Add missing info about where to call config functions to docs by @dcastil in https://github.com/dcastil/tailwind-merge/pull/264

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v1.13.2...v1.14.0

Bug Fixes

• Fix TypeScript issue when using moduleResolution: node16 by @LiamMartens in https://github.com/dcastil/tailwind-merge/pull/245

Documentation

• Fix grammar and typos in docs by @jmmarco in https://github.com/dcastil/tailwind-merge/pull/249
• Add tailwind-merge-php to similar packages in docs by @JamesHemery in https://github.com/dcastil/tailwind-merge/pull/246

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v1.13.1...v1.13.2

Thanks to @bluetch for sponsoring tailwind-merge! ❤️

Bug Fixes

• Fix basis-auto and basis-full not being merged correctly by @lukasz-kapica in https://github.com/dcastil/tailwind-merge/pull/242

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v1.13.0...v1.13.1

This release focuses on improvements to the docs.

Bug Fixes

• Fix arbitrary length 0 without unit not being recognized by @dcastil in https://github.com/dcastil/tailwind-merge/pull/237
• Fix typo in comment in default-config.ts by @CrutchTheClutch in https://github.com/dcastil/tailwind-merge/pull/227

Documentation

• Add intro video from Simon Vrachliotis to docs by @dcastil in https://github.com/dcastil/tailwind-merge/pull/239
  • @simonswiss made an intro video to tailwind-merge which I added to the docs. Check it out here!
• Add docs about when to use tailwind-merge by @dcastil in https://github.com/dcastil/tailwind-merge/pull/230
  • I added a new page to the docs about when and how to use tailwind-merge which should help you to decide whether you should use it and what alternative approaches exist.
• Make it clearer in docs that tailwind-merge supports composition of class strings by @dcastil in https://github.com/dcastil/tailwind-merge/pull/229

Other

• Add npm package provenance by @dcastil in https://github.com/dcastil/tailwind-merge/pull/219
  • GitHub introduced a new security feature to verify which source commit and build file were used for a specific npm package version. tailwind-merge now publishes provenance signatures alongside all releases on npm. Read more on the GitHub blog.

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v1.12.0...v1.13.0