Registry / devops / css-minimizer-webpack-plugin

css-minimizer-webpack-plugin

JSON →
library8.0.0jsnpmunverified

Webpack plugin that minifies CSS using cssnano, with optional support for csso, clean-css, esbuild, and swc. Current stable version is 8.0.0, released 2026-03-02, requiring Node.js >= 20.9.0 and Webpack ^5. Unlike optimize-css-assets-webpack-plugin, it offers better source map handling, caching, and parallel processing via worker threads. Release cadence is roughly annual with patch releases for bug fixes. Ships TypeScript types.

devopsweb-framework
npm install css-minimizer-webpack-plugin
github ↗package ↗homepage ↗
INSTALL
IMPORT
SIG · CSS-MINIMIZER-WEBP
C
css-minimizer-webpack-plugin
devopsjavascriptv8.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–226 runs
build_error
glibc
node 18–226 runs
build_error
Code
Verified usage

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

CssMinimizerPlugin
✓ const CssMinimizerPlugin = require('css-minimizer-webpack-plugin');
✗ import CssMinimizerPlugin from 'css-minimizer-webpack-plugin';
CommonJS default export. ESM import (import CssMinimizerPlugin) also works in Node >= 18 with package.json type:module, but TypeScript users must use esModuleInterop or default import.
typeof CssMinimizerPlugin
✓ import type { CssMinimizerPluginOptions } from 'css-minimizer-webpack-plugin';
✗ import CssMinimizerPluginOptions from 'css-minimizer-webpack-plugin';
TypeScript users should import the options type separately; the plugin itself is a class, not a type.

Basic webpack configuration integrating CssMinimizerPlugin with MiniCssExtractPlugin for CSS minification in production.

const CssMinimizerPlugin = require('css-minimizer-webpack-plugin'); const MiniCssExtractPlugin = require('mini-css-extract-plugin'); module.exports = { module: { rules: [ { test: /\.css$/, use: [MiniCssExtractPlugin.loader, 'css-loader'], }, ], }, optimization: { minimizer: [ new CssMinimizerPlugin(), ], }, plugins: [new MiniCssExtractPlugin()], };
Debug
Known issues
breakingMinimum supported Node.js version is 20.9.0 starting from v8.0.0.
fix
Upgrade Node.js to version >= 20.9.0.
affects: >=8.0.0
breakingMinimum supported Node.js version is 18.12.0 starting from v6.0.0.
fix
Upgrade Node.js to version >= 18.12.0.
affects: >=6.0.0 <8.0.0
breakingUpdated cssnano to v7 in v7.0.0; cssnano v7 has breaking changes.
fix
Review cssnano v7 migration guide: https://github.com/cssnano/cssnano/releases/tag/cssnano%406.0.0
affects: >=7.0.0
breakingUpdated cssnano to v6 in v5.0.0; cssnano v6 has breaking changes.
fix
Review cssnano v6 migration guide: https://github.com/cssnano/cssnano/releases/tag/cssnano%406.0.0
affects: >=5.0.0 <7.0.0
gotchaSource maps only work with source-map, inline-source-map, hidden-source-map, or nosources-source-map devtool values.
fix
Set devtool to one of the supported values (e.g., 'source-map').
affects: *
Errors
Common errors & fixes
Error: CssMinimizerPlugin is not a constructor
Using named import (import { CssMinimizerPlugin }) in CommonJS or incorrect import style.
fix
Use default import: import CssMinimizerPlugin from 'css-minimizer-webpack-plugin' or const CssMinimizerPlugin = require('css-minimizer-webpack-plugin').default
Module not found: Error: Can't resolve 'css-minimizer-webpack-plugin'
Package not installed or in devDependencies.
fix
Run 'npm install --save-dev css-minimizer-webpack-plugin'
TypeError: Cannot read properties of undefined (reading 'tapAsync')
Webpack version < 5 is used, or mismatched plugin version.
fix
Ensure Webpack >= 5 is installed and compatible plugin version.
Upgrade
Version history
8.0.0latest on npm
Audit
Dependencies
webpackrequiredpeer dependency; the plugin is a Webpack plugin and requires webpack 5.x
cssnanorequireddefault minifier; installed as a dependency of the plugin
Agent activity
8 hits · last 30 days
node
6
Resources
githubhttps://github.com/webpack/css-minimizer-webpack-plugin ↗
packagehttps://www.npmjs.com/package/css-minimizer-webpack-plugin ↗
homepagehttps://webpack.js.org/plugins/css-minimizer-webpack-plugin/ ↗
css-minimizer-webpack-plugin — npm install css-minimizer-webpack-plugin · libregistry