Registry / devops / esbuild-plugin-purgecss

esbuild-plugin-purgecss

JSON →
library0.0.6jsnpmunverified

An esbuild plugin that integrates PurgeCSS to remove unused CSS from your bundled output. Currently at version 0.0.6 (stable, no recent updates). It allows configuration via PurgeCSS options and content paths. Key differentiator: lightweight, zero-config setup for esbuild users wanting to eliminate dead CSS during bundling. Alternatives like purgecss-webpack-plugin are more complex and Webpack-specific. Supports TypeScript types. Release cadence: low—last update over a year ago.

devops
npm install esbuild-plugin-purgecss
github ↗package ↗
INSTALL
IMPORT
SIG · ESBUILD-PLUGIN-PUR
E
esbuild-plugin-purgecss
devopsjavascriptv0.0.6
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

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

default
✓ import purgecssPlugin from 'esbuild-plugin-purgecss'
✗ const { purgecssPlugin } = require('esbuild-plugin-purgecss')
Default export only; named import will fail.
default (CommonJS)
✓ const purgecssPlugin = require('esbuild-plugin-purgecss')
✗ const purgecssPlugin = require('esbuild-plugin-purgecss').default
CJS users: the plugin is the default export, no need for .default.
type definitions
✓ import purgecssPlugin from 'esbuild-plugin-purgecss'
TypeScript types are included; use default import for type safety.

Basic usage: removes unused CSS by scanning HTML files for class references. Configurable content paths and safelist.

import purgecssPlugin from 'esbuild-plugin-purgecss'; import * as esbuild from 'esbuild'; await esbuild.build({ entryPoints: ['src/index.js'], bundle: true, outfile: 'dist/bundle.js', plugins: [ purgecssPlugin({ content: ['./src/**/*.html'], safelist: ['keep-me'], }) ] });
Debug
Known issues
gotchaPlugin only runs on CSS output, not on CSS files imported in JS. You must extract CSS (e.g., with esbuild's CSS loader) before purging.
fix
Ensure your esbuild build outputs CSS to a file; plugin will process it automatically.
affects: >=0.0.0
deprecatedVersion 0.0.6 is the latest; no updates for over a year. May not support future esbuild versions.
fix
Consider switching to a more maintained alternative like purgecss-webpack-plugin if using webpack or check if the repo is active.
affects: <=0.0.6
breakingIncompatible with esbuild's native CSS minification if you rely on content analysis—only first pass is done.
fix
Disable esbuild's CSS minification or chain plugins carefully.
affects: >=0.0.0
gotchaPlugin options are passed directly to PurgeCSS; incorrect option names will silently fail (no error).
fix
Validate options against PurgeCSS documentation, e.g., use 'content' not 'paths'.
affects: >=0.0.0
Errors
Common errors & fixes
Error: Cannot find module 'purgecss'
Missing peer dependency purgecss.
fix
Install purgecss: npm install purgecss
TypeError: purgecssPlugin is not a function
Using named import instead of default import.
fix
Use default import: import purgecssPlugin from 'esbuild-plugin-purgecss'
No output files were generated
Content paths don't match any HTML/JS files; no CSS to purge.
fix
Ensure content globs correctly resolve to files that reference CSS classes.
Upgrade
Version history
0.0.6latest on npm
Audit
Dependencies
purgecssrequiredpeer dependency required for CSS removal logic
Agent activity
4 hits · last 30 days
node
4
Resources
githubhttps://github.com/GitHubJiKe/esbuild-plugin-purgecss ↗
packagehttps://www.npmjs.com/package/esbuild-plugin-purgecss ↗
esbuild-plugin-purgecss — npm install esbuild-plugin-purgecss · libregistry