PHPackages                             gehrisandro/tailwind-merge-laravel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. gehrisandro/tailwind-merge-laravel

ActiveLibrary[Utility & Helpers](/categories/utility)

gehrisandro/tailwind-merge-laravel
==================================

TailwindMerge for Laravel merges multiple Tailwind CSS classes by automatically resolving conflicts between them

v1.4.0(1mo ago)341682.2k—1.2%22[1 issues](https://github.com/gehrisandro/tailwind-merge-laravel/issues)[3 PRs](https://github.com/gehrisandro/tailwind-merge-laravel/pulls)15MITPHPPHP ^8.2.0CI passing

Since Jun 16Pushed 1mo ago2 watchersCompare

[ Source](https://github.com/gehrisandro/tailwind-merge-laravel)[ Packagist](https://packagist.org/packages/gehrisandro/tailwind-merge-laravel)[ GitHub Sponsors](https://github.com/gehrisandro)[ RSS](/packages/gehrisandro-tailwind-merge-laravel/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (22)Versions (13)Used By (15)

 [![TailwindMerge for Laravel](https://raw.githubusercontent.com/gehrisandro/tailwind-merge-laravel/main/art/example.png)](https://raw.githubusercontent.com/gehrisandro/tailwind-merge-laravel/main/art/example.png)

 [![GitHub Workflow Status (main)](https://camo.githubusercontent.com/39c7cbf48f802888c54a3ce69b746981c574be38e30853c8e97b09de3786b4c9/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f676568726973616e64726f2f7461696c77696e642d6d657267652d6c61726176656c2f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d726f756e642d737175617265)](https://github.com/gehrisandro/tailwind-merge-laravel/actions) [![Total Downloads](https://camo.githubusercontent.com/a737134e4c740b075f8c6a495807b47bc787a067b3e73a3025382606a97ebc62/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f676568726973616e64726f2f7461696c77696e642d6d657267652d6c61726176656c)](https://packagist.org/packages/gehrisandro/tailwind-merge-laravel) [![Latest Version](https://camo.githubusercontent.com/a3a0732f1b91e61daf6e9524917715491c788730ffb3af65231b53f597e02504/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f676568726973616e64726f2f7461696c77696e642d6d657267652d6c61726176656c)](https://packagist.org/packages/gehrisandro/tailwind-merge-laravel) [![License](https://camo.githubusercontent.com/9fcb43298dd2b355539cafd5c2cf98a7f1a5ea2d4089f8c444b2935a7bb23d79/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f676568726973616e64726f2f7461696c77696e642d6d657267652d6c61726176656c)](https://packagist.org/packages/gehrisandro/tailwind-merge-laravel)

---

**TailwindMerge for Laravel** allows you to merge multiple [Tailwind CSS](https://tailwindcss.com/) classes and automatically resolves conflicts between classes by removing classes conflicting with a class defined later. This is especially helpful when you want to override Tailwind CSS classes in your Blade components.

A Laravel / PHP port of [tailwind-merge](https://github.com/dcastil/tailwind-merge) by [dcastil](https://github.com/dcastil).

Supports Tailwind v3.0 up to v3.3.

If you find this package helpful, please consider sponsoring the maintainer:

- Sandro Gehri: **[github.com/sponsors/gehrisandro](https://github.com/sponsors/gehrisandro)**

> If you are **NOT** using Laravel, you can use the [TailwindMerge for PHP](https://github.com/gehrisandro/tailwind-merge-php) directly.

Table of Contents
-----------------

[](#table-of-contents)

- [Get Started](#get-started)
- [Usage](#usage)
    - [Laravel Blade Components](#use-in-laravel-blade-components)
    - [Laravel Blade Directive](#use-laravel-blade-directive)
    - [Everywhere else in Laravel](#everywhere-else-in-laravel)
- [Configuration](#configuration)
    - [Custom Tailwind Config](#custom-tailwind-config)
- [Contributing](#contributing)

Get Started
-----------

[](#get-started)

> **Requires [Laravel 10](https://github.com/laravel/laravel)**

First, install `TailwindMerge for Laravel` via the [Composer](https://getcomposer.org/) package manager:

```
composer require gehrisandro/tailwind-merge-laravel
```

Optionally, publish the configuration file:

```
php artisan vendor:publish --provider="TailwindMerge\Laravel\TailwindMergeServiceProvider"
```

This will create a `config/tailwind-merge.php` configuration file in your project, which you can modify to your needs using environment variables. For more information, see the [Configuration](#configuration) section:

```
TAILWIND_MERGE_PREFIX=tw-
```

Finally, you may use `TailwindMerge` in various places like your Blade components:

```
// circle.blade.php
twMerge('w-10 h-10 rounded-full bg-red-500') }}>

// your-view.blade.php

// output

```

`TailwindMerge` is not only capable of resolving conflicts between basic Tailwind CSS classes, but also handles more complex scenarios:

```
use TailwindMerge\Laravel\Facades\TailwindMerge;

// conflicting classes
TailwindMerge::merge('block inline'); // inline
TailwindMerge::merge('pl-4 px-6'); // px-6

// non-conflicting classes
TailwindMerge::merge('text-xl text-black'); // text-xl text-black

// with breakpoints
TailwindMerge::merge('h-10 lg:h-12 lg:h-20'); // h-10 lg:h-20

// dark mode
TailwindMerge::merge('text-black dark:text-white dark:text-gray-700'); // text-black dark:text-gray-700

// with hover, focus and other states
TailwindMerge::merge('hover:block hover:inline'); // hover:inline

// with the important modifier
TailwindMerge::merge('!font-medium !font-bold'); // !font-bold

// arbitrary values
TailwindMerge::merge('z-10 z-[999]'); // z-[999]

// arbitrary variants
TailwindMerge::merge('[&>*]:underline [&>*]:line-through'); // [&>*]:line-through

// non tailwind classes
TailwindMerge::merge('non-tailwind-class block inline'); // non-tailwind-class inline
```

It's possible to pass the classes as a string, an array or a combination of both:

```
TailwindMerge::merge('h-10 h-20'); // h-20
TailwindMerge::merge(['h-10', 'h-20']); // h-20
TailwindMerge::merge(['h-10', 'h-20'], 'h-30'); // h-30
TailwindMerge::merge(['h-10', 'h-20'], 'h-30', ['h-40']); // h-40
```

Usage
-----

[](#usage)

For in depth documentation and general PHP examples, take a look at the [gehrisandro/tailwind-merge-php](https://github.com/gehrisandro/tailwind-merge-php) repository.

### Use in Laravel Blade Components

[](#use-in-laravel-blade-components)

Create your Blade components as you normally would, but instead of specifying the `class` attribute directly, use the `mergeClasses` method:

```
// circle.blade.php
twMerge('w-10 h-10 rounded-full bg-red-500') }}>
```

Now you can use your Blade components and pass additional classes to merge:

```
// your-view.blade.php

```

This will render the following HTML:

```

```

> **Note:** Usage of `$attributes->merge(['class' => '...'])` is currently not supported due to limitations in Laravel.

#### Merge classes on multiple elements

[](#merge-classes-on-multiple-elements)

By default Laravel allows you to only merge classes in one place. But with `TailwindMerge` you can merge classes on multiple elements by using `twMergeFor()`:

```
// button.blade.php
withoutTwMergeClasses()->twMerge('p-2 bg-gray-900 text-white') }}>
    twMergeFor('icon', 'h-4 text-gray-500') }} viewBox="0 0 448 512">

    {{ $slot }}

```

You can now specify additional classes for the button and the svg icon:

```
// your-view.blade.php

  Click Me

```

This will render the following HTML:

```

  Click Me

```

> Note: Use `withoutTwMergeClasses()` on your main attributes bag, otherwise all `class:xyz` attributes will be rendered in the output.

### Use Laravel Blade Directive

[](#use-laravel-blade-directive)

The package registers a Blade directive which can be used to merge classes in your Blade views:

```
@twMerge('w-10 h-10 rounded-full bg-red-500 bg-blue-500') // w-10 h-10 rounded-full bg-blue-500

// or multiple arguments
@twMerge('w-10 h-10 rounded-full bg-red-500', 'bg-blue-500') // w-10 h-10 rounded-full bg-blue-500
```

If you want to rename the blade directive, you can do so in the `config/tailwind-merge.php` configuration file:

```
// config/tailwind-merge.php
return [
    'blade_directive' => 'customTwMerge',
];
```

You could even disable the directive completely by setting it to `null`:

```
// config/tailwind-merge.php
return [
    'blade_directive' => null,
];
```

### Everywhere else in Laravel

[](#everywhere-else-in-laravel)

If you don't use Laravel Blade, you can still use `TailwindMerge` by using the Facade or the helper method directly:

#### Facade

[](#facade)

```
use TailwindMerge\Laravel\Facades\TailwindMerge;

TailwindMerge::merge('w-10 h-10 rounded-full bg-red-500 bg-blue-500'); // w-10 h-10 rounded-full bg-blue-500
```

#### Helper Method

[](#helper-method)

```
twMerge('w-10 h-10 rounded-full bg-red-500 bg-blue-500'); // w-10 h-10 rounded-full bg-blue-500
```

### More usage examples

[](#more-usage-examples)

Take a look at the [TailwindMerge for PHP](https://github.com/gehrisandro/tailwind-merge-php) repository.

Configuration
-------------

[](#configuration)

If you are using Tailwind CSS without any extra config, you can use TailwindMerge right away. And stop reading here.

If you're using a custom Tailwind config, you may need to configure TailwindMerge as well to merge classes properly.

By default TailwindMerge is configured in a way that you can still use it if all the following apply to your Tailwind config:

- Only using color names which don't clash with other Tailwind class names
- Only deviating by number values from number-based Tailwind classes
- Only using font-family classes which don't clash with default font-weight classes
- Sticking to default Tailwind config for everything else

If some of these points don't apply to you, you need to customize the configuration.

### Configure Prefix

[](#configure-prefix)

You can configure the prefix directly in the `config/tailwind-merge.php` configuration file or by setting the environment variable:

```
TAILWIND_MERGE_PREFIX=tw-
```

### Modify merge process

[](#modify-merge-process)

If TailwindMerge is not able to merge your changes properly you can modify the merge process by modifying existing class groups or adding new class groups.

For example, if you want to add a custom font size of "very-large":

```
// config/tailwind-merge.php

return [
  'classGroups' => [
      'font-size' => [
          ['text' => ['very-large']]
      ],
  ],
];
```

For a more detailed explanation of the configuration options, visit the [original package documentation](https://github.com/dcastil/tailwind-merge/blob/v1.14.0/docs/configuration.md).

Contributing
------------

[](#contributing)

Thank you for considering contributing to `TailwindMerge for Laravel`! The contribution guide can be found in the [CONTRIBUTING.md](CONTRIBUTING.md) file.

---

`TailwindMerge for PHP` is an open-sourced software licensed under the **[MIT license](https://opensource.org/licenses/MIT)**.

###  Health Score

63

—

FairBetter than 99% of packages

Maintenance88

Actively maintained with recent releases

Popularity58

Moderate usage in the ecosystem

Community29

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 86.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~112 days

Recently: every ~221 days

Total

10

Last Release

59d ago

Major Versions

v0.2.1 → v1.0.02023-10-18

PHP version history (2 changes)v0.0.1PHP ^8.1.0

v1.4.0PHP ^8.2.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/6180f55dc35aac59961f36ce372004c3d00c7447c9e9a4b78e8eff6d8e3b0840?d=identicon)[gehrisandro](/maintainers/gehrisandro)

---

Top Contributors

[![gehrisandro](https://avatars.githubusercontent.com/u/25097194?v=4)](https://github.com/gehrisandro "gehrisandro (33 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (2 commits)")[![ash-jc-allen](https://avatars.githubusercontent.com/u/39652331?v=4)](https://github.com/ash-jc-allen "ash-jc-allen (1 commits)")[![heyjorgedev](https://avatars.githubusercontent.com/u/2780099?v=4)](https://github.com/heyjorgedev "heyjorgedev (1 commits)")[![RVxLab](https://avatars.githubusercontent.com/u/46111684?v=4)](https://github.com/RVxLab "RVxLab (1 commits)")

---

Tags

phplaravelmergeclassestailwindcss

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/gehrisandro-tailwind-merge-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/gehrisandro-tailwind-merge-laravel/health.svg)](https://phpackages.com/packages/gehrisandro-tailwind-merge-laravel)
```

###  Alternatives

[appstract/laravel-opcache

PHP OPcache Artisan commands for Laravel.

1.4k4.9M7](/packages/appstract-laravel-opcache)[gehrisandro/tailwind-merge-php

TailwindMerge for PHP merges multiple Tailwind CSS classes by automatically resolving conflicts between them

1391.5M9](/packages/gehrisandro-tailwind-merge-php)[backpack/basset

Dead-simple way to load CSS or JS assets only once per page, when using Laravel 10+.

202832.4k6](/packages/backpack-basset)[firefly-iii/data-importer

Firefly III Data Import Tool.

7545.8k](/packages/firefly-iii-data-importer)[nickurt/laravel-akismet

Akismet for Laravel 11.x/12.x/13.x

97139.6k2](/packages/nickurt-laravel-akismet)[nickurt/laravel-stopforumspam

StopForumSpam for Laravel 11.x/12.x/13.x

6953.9k](/packages/nickurt-laravel-stopforumspam)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)