hub / github.com/dcastil/tailwind-merge

github.com/dcastil/tailwind-merge

repository ↗ · DeepWiki ↗ · release tailwind-merge@3.7.0 ↗ · + Follow · compare 2 versions

449 symbols 1,486 edges 157 files ⚖ MIT 107 documented · 24% ● updated 2d agotailwind-merge@3.7.0 · 2026-09-12★ 5,68921 open issues

Browse by type

⨍ Functions 395◇ Types & classes 54

What it actually does AI analysis from the code graph — generated when you open this

loading…

README

<a href="https://github.com/dcastil/tailwind-merge">
    <img src="https://github.com/dcastil/tailwind-merge/raw/tailwind-merge@3.7.0/packages/tailwind-merge/assets/logo.svg" alt="tailwind-merge" height="150px" />
</a>

tailwind-merge

Utility function to efficiently merge Tailwind CSS classes in JS without style conflicts.

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 v4.0 up to v4.3 (if you use Tailwind v3, use tailwind-merge v2.6.0)
Works in all modern browsers and maintained Node versions
Fully typed, with published declarations compatible with TypeScript 3.8 and newer
Check bundle size on Bundlephobia

Get started

Packages in this repository

This repository is a monorepo. The docs above belong to the tailwind-merge package — what most visitors are here for — and everything package-specific (source, docs, changelog) lives in the package directories.

Package	Description
tailwind-merge (npm)	The library itself — see the docs above.
@tailwind-merge/vite	Automatic theme configuration and source-based pruning for Vite apps. Unreleased.
@tailwind-merge/configurator	JavaScript API and CLI for generating a theme-specific merge module. Unreleased; API remains unstable.

Extension points exported contracts — how you extend this code

ConfigStaticPart (Interface)

* The static part of the tailwind-merge configuration. When merging multiple configurations, the properties of this inte

packages/tailwind-merge/src/lib/types.ts

CustomUtilityGroup (Interface)

Members and their representative class travel together, so override inference never has to reconstruct a utility root fr

packages/configurator/src/custom-utilities.ts

TailwindMergeOptions (Interface)

(no doc)

packages/vite/src/index.ts

ConfigGroupsPart (Interface)

* The dynamic part of the tailwind-merge configuration. When merging multiple configurations, the user can choose to eit

packages/tailwind-merge/src/lib/types.ts

ConstantCandidate (Interface)

A resolved theme scale emitted as a shared const, referenced or spread wherever a group array contains it.

packages/configurator/src/emit.ts

PruneOptions (Interface)

(no doc)

packages/vite/src/index.ts

browse all types & interfaces →

Core symbols most depended-on inside this repo

↓ 13 filesdeclaredDeclarations

packages/configurator/src/design-system.ts

↓ 11 filesemitModule

packages/configurator/src/emit.ts

↓ 7 filesmaterializeConfig

packages/configurator/src/materialize.ts

↓ 6 filesDesignSystemAccess

packages/configurator/src/design-system.ts

↓ 5 filesSourceScanner

packages/configurator/src/scan.ts

↓ 5 filesprunePlan

packages/configurator/src/prune.ts

browse all functions →

Shape

Function 385

Interface 54

Method 10

Languages

TypeScript100%

Modules by API surface

packages/tailwind-merge/src/lib/validators.ts39 symbols

packages/tailwind-merge/src/lib/default-config.ts33 symbols

packages/vite/src/index.ts23 symbols

packages/configurator/src/emit.ts23 symbols

packages/configurator/src/plan.ts20 symbols

packages/configurator/src/design-system.ts20 symbols

packages/configurator/tests/fixture-utils.ts19 symbols

packages/tailwind-merge/src/lib/class-group-utils.ts18 symbols

packages/configurator/src/custom-utilities.ts18 symbols

packages/vite/tests/helpers.ts13 symbols

packages/vite/src/generation.ts13 symbols

packages/vite/src/generation-session.ts11 symbols

Dependencies from manifests, versioned

@babel/core8.0.1 · 1×

@babel/preset-env8.0.2 · 1×

@codspeed/vitest-plugin5.7.1 · 1×

@rollup/plugin-babel7.1.0 · 1×

@rollup/plugin-node-resolve16.0.3 · 1×

@rollup/plugin-typescript12.3.0 · 1×

@tailwind-merge/configuratorworkspace:* · 1×

@tailwindcss/node4.3.3 · 1×

@tailwindcss/oxide4.3.3 · 1×

@tailwindcss/vite4.3.3 · 1×

@types/nodecatalog: · 1×

@vitest/coverage-v84.1.10 · 1×

For agents

$ claude mcp add tailwind-merge \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

github.com/dcastil/tailwind-merge @tailwind-merge@3.7.0@v3.6.0

tailwind-merge

Get started

Packages in this repository

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Languages

Modules by API surface

Dependencies from manifests, versioned

For agents

Ask about this repo answers extend the page

github.com/dcastil/tailwind-merge