This package follows the SemVer versioning rules. More specifically:
-
Patch version gets incremented when unintended behavior is fixed, which doesn't break any existing API. Note that bug fixes can still alter which styles are applied. E.g. a bug gets fixed in which the conflicting classes
inline
andblock
weren't merged correctly so that both would end up in the result. -
Minor version gets incremented when additional features are added which don't break any existing API. However, a minor version update might still alter which styles are applied if you use Tailwind features not yet supported by tailwind-merge. E.g. a new Tailwind prefix
magic
gets added to this package which changes the result oftwMerge('magic:px-1 magic:p-3')
frommagic:px-1 magic:p-3
tomagic:p-3
. -
Major version gets incremented when breaking changes are introduced to the package API. E.g. the return type of
twMerge
changes. -
alpha
releases might introduce breaking changes on any update. Whereasbeta
releases only introduce new features or bug fixes. -
Releases with major version 0 might introduce breaking changes on a minor version update.
-
A non-production-ready version of every commit pushed to the main branch is released under the
dev
tag for testing purposes. It has a format like1.6.1-dev.4202ccf913525617f19fbc493db478a76d64d054
in which the first numbers are the corresponding last release and the hash at the end is the git SHA of the commit. You can install the latest dev release withyarn add tailwind-merge@dev
. -
A changelog is documented in GitHub Releases.
Next: Contributing
Previous: Writing plugins