Registry / devops / esbuild-plugin-tailwindcss

esbuild-plugin-tailwindcss

library2.2.0jsnpmunverified

esbuild plugin that integrates TailwindCSS into the build pipeline. Current stable version is 2.2.0, compatible with TailwindCSS v4. For TailwindCSS v3, use version 1.x. The plugin handles TailwindCSS processing via PostCSS, supports CSS Modules, custom PostCSS plugins, and Autoprefixer. It works with esbuild and Bun. Provides ESM and CJS exports with TypeScript type definitions.

devops

npm install esbuild-plugin-tailwindcss

github ↗package ↗

INSTALL

IMPORT

SIG · ESBUILD-PLUGIN-TAI

esbuild-plugin-tailwindcss

devopsjavascriptv2.2.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import tailwindPlugin from 'esbuild-plugin-tailwindcss'

✗ const tailwindPlugin = require('esbuild-plugin-tailwindcss')

Plugin is exported as default export. Both ESM and CJS are supported.

tailwindPlugin (named)

✓ import { tailwindPlugin } from 'esbuild-plugin-tailwindcss'

A named export 'tailwindPlugin' is also available, identical to default.

PluginOptions type

✓ import type { PluginOptions } from 'esbuild-plugin-tailwindcss'

✗ import { PluginOptions } from 'esbuild-plugin-tailwindcss'

PluginOptions is a TypeScript type, use 'import type' for type-only imports.

Shows how to configure esbuild with the TailwindCSS plugin, including minimal options.

import esbuild from 'esbuild'; import tailwindPlugin from 'esbuild-plugin-tailwindcss'; await esbuild.build({ entryPoints: ['src/index.js'], outdir: 'dist', bundle: true, plugins: [ tailwindPlugin({ postcssPlugins: { prepend: [], append: [], disableAutoprefixer: false }, cssModules: { enabled: false } }) ] });

Debug

Known issues

breakingVersion 2.x requires TailwindCSS v4. Using with v3 will break.

fix

Use version 1.x for TailwindCSS v3: npm install esbuild-plugin-tailwindcss@^1.0.0

affects: >=2.0.0

deprecatedThe 'options' object in the main function call was deprecated in v2 in favor of nested postcssPlugins and cssModules.

fix

Use new option structure: { postcssPlugins: { ... }, cssModules: { ... } }

affects: >=2.0.0

gotchaCSS Modules: 'getJSON' callback is managed internally by the plugin. To get class mappings, listen to the 'css-modules' event on the plugin instance.

fix

Use the plugin's event emitter to capture class name mappings.

affects: >=2.0.0

gotchaThe @import "tailwindcss" statement must be in your CSS file; otherwise TailwindCSS is not processed.

fix

Add @import "tailwindcss"; to your main CSS file.

affects: >=2.0.0

gotchaWhen using CSS Modules, the plugin will not process files that match the exclude regex. Non-matching files are left as-is.

fix

Ensure your CSS module files match the default /\\.module\\.css$/ pattern or adjust filter.

affects: >=2.0.0

Errors

Common errors & fixes

Error: Cannot find module 'tailwindcss'

Peer dependency tailwindcss is not installed.

fix

Install tailwindcss: npm install -D tailwindcss

Error: @import "tailwindcss" not found

Missing TailwindCSS import in CSS file.

fix

Add @import "tailwindcss"; at the top of your main CSS file.

TypeError: plugin is not a function

Attempted to use a named import incorrectly (e.g., import { tailwindPlugin } when using require).

fix

Use default import: import tailwindPlugin from 'esbuild-plugin-tailwindcss'

Error: PostCSS plugin tailwindcss requires Tailwind Config

TailwindCSS v4 expects a configuration file or proper setup; see TailwindCSS v4 migration.

fix

Create a tailwind.config.js or use TailwindCSS v4's new configuration approach (css-based).

Upgrade

Version history

2.2.0latest on npm

Audit

Dependencies

tailwindcssrequiredPeer dependency; the plugin requires TailwindCSS to be installed.

esbuildrequiredPeer dependency; the plugin is used as an esbuild plugin.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/ttempaa/esbuild-plugin-tailwindcss ↗

packagehttps://www.npmjs.com/package/esbuild-plugin-tailwindcss ↗