npm · #1561 most downloaded on npm

tailwind-merge

3.7.0313M downloads/modcastil/tailwind-merge ↗New releases in your daily digest, changelog included.

Merge Tailwind CSS classes without style conflicts

Last release 16 days ago
13 Sep 2026
Ships on a steady schedule
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
474 releases · first in 2021

Release timeline

474 releases since 2021

202120222023202420252026

20212026

One column per quarter.

Releases

0.8.021 Oct 2021Breaking
This is a big release with breaking changes. These were necessary to improve the API before the coming v1.0.0 release and to add better plugin support…
Summary

This is a big release with breaking changes. These were necessary to improve the API before the coming v1.0.0 release and to add better plugin support. If you feel like writing a plugin, check out the plugins section in the docs!

Breaking Changes

Previously there was a list of prefixes in the tailwind-merge config which was used to match Tailwind prefixes. I removed those and match all prefixes as valid Tailwind prefixes. This is only a breaking change if you use non-Tailwind classes with : in them which look like Tailwind classes after the prefix. tailwind-merge will treat those as Tailwind classes and resolve conflicts incorrectly. (https://github.com/dcastil/tailwind-merge/pull/50)

createTailwindMerge

If you added custom prefixes to your tailwind-merge config, you can remove them now. If you use TypeScript, you need to remove them. (https://github.com/dcastil/tailwind-merge/pull/50)

Doesn't get passed the getDefaultConfig callback anymore. You need to call the exported function getDefaultConfig instead to get the default config. (https://github.com/dcastil/tailwind-merge/pull/42)

You probably don't need createTailwindMerge anyway. Use the new and much simpler to use extendTailwindMerge instead. (https://github.com/dcastil/tailwind-merge/pull/49)

New Features

Add plugin documentation by @dcastil in https://github.com/dcastil/tailwind-merge/pull/51

(Breaking change) Consider all prefixes as valid Tailwind prefixes by @dcastil in https://github.com/dcastil/tailwind-merge/pull/50

Add extendTailwindMerge function by @dcastil in https://github.com/dcastil/tailwind-merge/pull/49

Add mergeConfigs function by @dcastil in https://github.com/dcastil/tailwind-merge/pull/45

(Breaking change) Code-split default config out by @dcastil in https://github.com/dcastil/tailwind-merge/pull/42

Enable multiple createConfig functions by @dcastil in https://github.com/dcastil/tailwind-merge/pull/40

Add validators to package exports by @dcastil in https://github.com/dcastil/tailwind-merge/pull/38

Bug Fixes

Remove unwated side effects when mutating default config by @dcastil in https://github.com/dcastil/tailwind-merge/pull/43

Also added the Config type to the package exports

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v0.7.1...v0.8.0

0.7.118 Oct 2021

Fix CommonJS imports not working by @navin-moorthy and @dcastil in https://github.com/dcastil/tailwind-merge/pull/31

Bug Fixes

Fix CommonJS imports not working by @navin-moorthy and @dcastil in https://github.com/dcastil/tailwind-merge/pull/31

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v0.7.0...v0.7.1

Open source →

0.7.017 Sept 2021

Allow passing false to twMerge by @dcastil in https://github.com/dcastil/tailwind-merge/pull/25

New Features

Allow passing false to twMerge by @dcastil in https://github.com/dcastil/tailwind-merge/pull/25

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v0.6.0...v0.7.0

Open source →

0.6.028 Aug 2021

Allow passing null as argument to twMerge #20 by @dcastil

New Features

Allow passing null as argument to twMerge #20 by @dcastil

Bug Fixes

Fix merges with important modifier not working when using prefixed classes by @dcastil in https://github.com/dcastil/tailwind-merge/pull/22

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v0.5.2...v0.6.0

Open source →

0.5.223 Aug 2021

Add support for custom classes like cursor-[grab] by @dcastil in https://github.com/dcastil/tailwind-merge/pull/19

Bug Fixes

Add support for custom classes like cursor-[grab] by @dcastil in https://github.com/dcastil/tailwind-merge/pull/19
Fix incorrect conflicts in Font Variant Numeric classes by @dcastil in https://github.com/dcastil/tailwind-merge/pull/18

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v0.5.1...v0.5.2

Open source →

0.5.117 Aug 2021

Fix incorrect conflict between ring and shadow by @dcastil in https://github.com/dcastil/tailwind-merge/pull/15

Bug Fixes

Fix incorrect conflict between ring and shadow by @dcastil in https://github.com/dcastil/tailwind-merge/pull/15
Fix not all JIT-enabled pseudo variants working by @dcastil in https://github.com/dcastil/tailwind-merge/pull/14

Other

Add CodeQL security analysis to repo by @dcastil in https://github.com/dcastil/tailwind-merge/pull/10

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v0.5.0...v0.5.1

Open source →

0.5.022 Jul 2021

Add support for Tailwind CSS v2.2.6 by @dcastil in https://github.com/dcastil/tailwind-merge/pull/8

New Features

Add support for Tailwind CSS v2.2.6 by @dcastil in https://github.com/dcastil/tailwind-merge/pull/8
Delay twMerge initialization until first call by @dcastil in https://github.com/dcastil/tailwind-merge/pull/7

Other

Make logo in README version-specific by @dcastil in https://github.com/dcastil/tailwind-merge/pull/6

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v0.4.0...v0.5.0

Open source →

0.4.022 Jul 2021Breaking

(Breaking change) Simplify config by @dcastil in https://github.com/dcastil/tailwind-merge/pull/3

Breaking Changes

createTailwindMerge
- Config type changed and returned object from getDefaultConfig changed. (https://github.com/dcastil/tailwind-merge/pull/3)
  - dynamicClasses and standaloneClasses were merged into classGroups
  - conflictingGroups were renamed to conflictingClassGroups
  - Class group IDs are keys of classGroups object instead of full path to class group. E.g. dynamicClasses.foo.0 → foo.

New Features

(Breaking change) Simplify config by @dcastil in https://github.com/dcastil/tailwind-merge/pull/3
Add support for Tailwind v2.2.5 by @dcastil in https://github.com/dcastil/tailwind-merge/pull/2

Bug Fixes

Fix non-conflicting border classes being merged incorrectly by @dcastil in https://github.com/dcastil/tailwind-merge/pull/5

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v0.3.0...v0.4.0

Open source →

0.3.020 Jul 2021

Enable named class group collections by @dcastil in 16a31751fdfd87c39683fb4506dec6a0bf118772

New Features

Enable named class group collections by @dcastil in 16a31751fdfd87c39683fb4506dec6a0bf118772
- Class group collections in config can be an object, so you can use group references like dynamicClasses.flex.direction instead of just index-based ones like dynamicClasses.flex.0. More info on this in the createTailwindMerge() API reference.

Bug Fixes

Fix small typos in README by @KeKs0r in https://github.com/dcastil/tailwind-merge/pull/1

Other

tailwind-merge now has a logo by @dcastil in 9402c8ec1b19714bb8ecb158eb124b89a8c1ba64, b96997942d4e92e045c9b08e7314843305b41fe2, dae2aaabf8c00b0d5086aff744aa2c53513daf33, e9e88060578483a3ed4728430f7b188e51aaef49, 4e2d9f160dae00e18ebcbecf54f4dd33dc4264bb <br /><br /><img src="https://github.com/dcastil/tailwind-merge/raw/v0.3.0/assets/logo.svg" alt="tailwind-merge" width="200px" />

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v0.2.0...v0.3.0

Open source →

0.2.018 Jul 2021

Add support for important modifier by @dcastil in 17a9e9d9d805ba585372e01a9eefae1dba89368b

New Features

Add support for important modifier by @dcastil in 17a9e9d9d805ba585372e01a9eefae1dba89368b
Add support for per-side border colors by @dcastil in 6cd9ee255e1a6fb42e5262b7835f876e2ce8e3ae
Add support for content utiltites by @dcastil in fd097c611b5fa02ff6142b66f5ad96d596feed42
Add support for caret color by @dcastil in fd097c611b5fa02ff6142b66f5ad96d596feed42
Add support for JIT-only prefixes by @dcastil in fd097c611b5fa02ff6142b66f5ad96d596feed42
Mark package as side effect-free by @dcastil in 6d00af33049c3c7171bce3f1affd561986cc6bfe

Bug Fixes

Fix classes like bottom-auto not being detected as Tailwind classesby @dcastil in ec65b84f0aab57d1305019e4a143772d675798a2

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v0.1.2...v0.2.0

Open source →

0.1.218 Jul 2021

Fix errors when importing tailwind-merge as third party dependency. by @dcastil in 3335956da15fdcc484904976864816413fad68f6

Bug Fixes

Fix errors when importing tailwind-merge as third party dependency. by @dcastil in 3335956da15fdcc484904976864816413fad68f6

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v0.1.1...v0.1.2

Open source →

0.1.118 Jul 2021

No changes here. Just testing automated npm publish.

Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v0.1.0...v0.1.1

Open source →

0.1.018 Jul 2021

First published version of tailwind-merge. 🎉

Full Changelog: https://github.com/dcastil/tailwind-merge/commits/v0.1.0

Open source →

0.0.0-dev.f5d2c2c2fa0614becc4ddb0c1994421127388af413 Aug 2022pre-release