Registry / web-framework / rollup-plugin-tailwindcss

rollup-plugin-tailwindcss

library1.0.0jsnpmunverified

Rollup plugin that bundles a Tailwind CSS stylesheet as a Rollup asset, supporting tree-shaking via purge options. Current version 1.0.0, last updated in 2020. Low release cadence. Key differentiator: minimal configuration for integrating Tailwind CSS with Rollup-based builds, unlike full Webpack setups.

web-framework devops

npm install rollup-plugin-tailwindcss

github ↗package ↗

INSTALL

IMPORT

SIG · ROLLUP-PLUGIN-TAIL

rollup-plugin-tailwindcss

web-frameworkjavascriptv1.0.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 tailwind from 'rollup-plugin-tailwindcss'

✗ const tailwind = require('rollup-plugin-tailwindcss')

ESM-only; no CommonJS exports

tailwind

✓ import { tailwind } from 'rollup-plugin-tailwindcss'

✗ import tailwind from 'rollup-plugin-tailwindcss'

Named export is not available, only default export works

PluginOptions

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

TypeScript type; only available in v1.0.0+ (no types in earlier versions)

Minimal Rollup config using the plugin with purge. Replace 'src/tailwind.css' and content paths as needed.

// rollup.config.js import tailwind from 'rollup-plugin-tailwindcss'; export default { input: 'src/index.js', output: { dir: 'dist', format: 'esm' }, plugins: [ tailwind({ input: 'src/tailwind.css', purge: { enabled: true, content: ['./src/**/*.js'], options: { defaultExtractor: (content) => content.match(/[\w-/:]+(?<!:)/g) || [] } } }) ] };

Debug

Known issues

deprecatedThis plugin has not been updated for Tailwind CSS v2+ and is no longer maintained.

fix

Switch to '@tailwindcss/rollup-plugin' or use PostCSS with rollup-plugin-postcss

affects: >=1.0.0

breakingPurge configuration is incompatible with Tailwind CSS v2.0.0's built-in purge

fix

Use Tailwind CSS v1 or migrate to v2 and use tailwindcss/rollup-plugin

affects: >=1.0.0

gotchaThe plugin only handles a single CSS entry; multiple entry points are not supported

fix

Use separate plugin instances for each entry or combine stylesheets beforehand

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'tailwindcss'

tailwindcss not installed as peer dependency

fix

npm install tailwindcss --save-dev

SyntaxError: Unexpected token 'export'

ESM import used in CommonJS environment

fix

Use import syntax in .mjs file or configure Rollup to handle ESM

Error: No input file specified. Use the 'input' option.

Missing 'input' option in plugin config

fix

Add input: 'path/to/your.css' to the plugin options

TypeError: Cannot destructure property 'tailwind' of ... undefined

Incorrect named import instead of default

fix

Use import tailwind from 'rollup-plugin-tailwindcss' (not { tailwind })

Upgrade

Version history

1.0.0latest on npm

Audit

Dependencies

rolluprequiredpeer dep: >=1.19.0

tailwindcssrequiredpeer dep: ^1.0.0

Agent activity

8 hits · last 30 days

node

Resources

githubhttps://github.com/alexdilley/rollup-plugin-tailwindcss ↗

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