css-minify

library2.1.0jsnpmunverified

A CSS compression tool for Node.js (v2.1.0, last updated 2020). Provides CLI and programmatic API to minify CSS files. Unlike more complex tools (e.g., csso, clean-css), it focuses on simplicity: single-file, directory batch, or STDIN input. Outputs .min.css files. Minimal dependencies, no build step required. Suitable for quick minification in scripts or pipelines.

devops

npm install css-minify

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · CSS-MINIFY

css-minify

devopsjavascriptv2.1.0

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.

cssminify

✓ import cssminify from 'css-minify'

✗ const cssminify = require('css-minify')

Package ships ESM by default as of v2. In CJS contexts, use dynamic import() or check if default export works with require().

cssminify

✓ import cssminify from 'css-minify'

✗ import { cssminify } from 'css-minify'

Package exports a default function, not a named export.

cssminify

✓ const cssminify = (await import('css-minify')).default

✗ const cssminify = require('css-minify')

Recommended pattern for CommonJS modules to correctly access the default export.

Minifies a CSS string with default settings and then with compatibility mode enabled (preserves IE filters). Outputs to console.

import cssminify from 'css-minify'; const input = 'body { color: #ff0000; }'; const minified = cssminify(input); console.log(minified); // body{color:red} // With options (compatibility mode: keep IE filters) const options = { compatibility: true }; const withCompat = cssminify(input, options); console.log(withCompat); // unchanged if IE filters present

Debug

Known issues

breakingFrom v2.0.0, package became ESM-only. Direct require() may fail in older Node versions or CJS projects.

fix

Use dynamic import() or upgrade to Node 14+ with "type": "module" in package.json.

affects: >=2.0.0

deprecatedThe 'compatibility' option may be removed in a future major version; its behavior is not fully documented.

fix

Avoid relying on compatibility mode for production; test output thoroughly.

affects: >=2.0.0

gotchaCLI can hang if STDIN is used without piped input and no file/dir specified. The tool waits for input indefinitely.

fix

Always provide input via file, directory, or pipe; avoid running without arguments.

affects: >=1.0.0

gotchaInput file must have .css extension; otherwise CLI will skip it silently.

fix

Rename files to end with .css before processing.

affects: >=1.0.0

breakingDefault output directory changed from 'minified' to 'css-dist' in v1.1.0. Scripts relying on the old default may break.

fix

Use -o flag to specify output directory explicitly.

affects: >=1.1.0

Errors

Common errors & fixes

ReferenceError: require is not defined in ES module scope, you can use import instead

Using require() in an ESM context with v2+ of css-minify.

fix

Replace require('css-minify') with import cssminify from 'css-minify'.

SyntaxError: Cannot use import statement outside a module

Using import syntax in a CommonJS project without setting type: module.

fix

Rename file to .mjs or add "type": "module" to package.json. Alternatively, use dynamic import().

TypeError: cssminify is not a function

Using named import (import { cssminify }) or wrong default from CJS require.

fix

Use import cssminify from 'css-minify' or in CJS: const cssminify = require('css-minify').default (if available).

Upgrade

Version history

2.1.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

15 hits · last 30 days

node

Amazon

Resources

githubssh://git@github.com/purple-force/css-minify ↗

packagecss-minify ↗

homepagehttps://github.com/purple-force/css-minify#readme ↗