Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/dcastil/tailwind-merge

Merge Tailwind CSS classes without style conflicts
https://github.com/dcastil/tailwind-merge

css tailwindcss utility-classes

Last synced: 4 months ago
JSON representation

Merge Tailwind CSS classes without style conflicts

Lists

README

        





tailwind-merge

# tailwind-merge

Utility function to efficiently merge [Tailwind CSS](https://tailwindcss.com) classes in JS without style conflicts.

```ts
import { twMerge } from 'tailwind-merge'

twMerge('px-2 py-1 bg-red hover:bg-dark-red', 'p-3 bg-[#B91C1C]')
// → 'hover:bg-dark-red p-3 bg-[#B91C1C]'
```

- Supports Tailwind v3.0 up to v3.4 (if you use Tailwind v2, use [tailwind-merge v0.9.0](https://github.com/dcastil/tailwind-merge/tree/v0.9.0))
- Works in all modern browsers and maintained Node versions
- Fully typed
- [Check bundle size on Bundlephobia](https://bundlephobia.com/package/tailwind-merge)

## Get started

- [What is it for](https://github.com/dcastil/tailwind-merge/tree/v2.2.1/docs/what-is-it-for.md)
- [When and how to use it](https://github.com/dcastil/tailwind-merge/tree/v2.2.1/docs/when-and-how-to-use-it.md)
- [Features](https://github.com/dcastil/tailwind-merge/tree/v2.2.1/docs/features.md)
- [Limitations](https://github.com/dcastil/tailwind-merge/tree/v2.2.1/docs/limitations.md)
- [Configuration](https://github.com/dcastil/tailwind-merge/tree/v2.2.1/docs/configuration.md)
- [Recipes](https://github.com/dcastil/tailwind-merge/tree/v2.2.1/docs/recipes.md)
- [API reference](https://github.com/dcastil/tailwind-merge/tree/v2.2.1/docs/api-reference.md)
- [Writing plugins](https://github.com/dcastil/tailwind-merge/tree/v2.2.1/docs/writing-plugins.md)
- [Versioning](https://github.com/dcastil/tailwind-merge/tree/v2.2.1/docs/versioning.md)
- [Contributing](https://github.com/dcastil/tailwind-merge/tree/v2.2.1/docs/contributing.md)
- [Similar packages](https://github.com/dcastil/tailwind-merge/tree/v2.2.1/docs/similar-packages.md)