Registry / devops / gulp-crass-minifier

gulp-crass-minifier

library1.0.0jsnpmunverified

Gulp plugin wrapping the Crass CSS optimizer for advanced CSS minification via full CSS parsing, enabling optimizations like redundant rule elimination and property merging that string-based minifiers cannot achieve. Version 1.0.0 depends on Crass, which carries a known security vulnerability (GitHub issue #77) making it unsafe for production environments. The plugin is in maintenance mode; it has no recent updates and a TODO list for tests. It supports custom options for prettification, optimization levels, CSS4 features, and browser targeting. Consider faster, safer alternatives like cssnano or clean-css.

devops

npm install gulp-crass-minifier

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · GULP-CRASS-MINIFIE

gulp-crass-minifier

devopsjavascriptv1.0.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.

default

✓ const crass = require('gulp-crass-minifier');

✗ import crass from 'gulp-crass-minifier';

CommonJS only; no default ESM export provided.

default

✓ import crass from 'gulp-crass-minifier';

✗ const crass = require('gulp-crass-minifier').default;

ESM import works if the environment supports ESM, but the package does not export a .default property.

default

✓ const {default: crass} = await import('gulp-crass-minifier');

✗ const crass = require('gulp-crass-minifier').default;

Dynamic import with named export access is the safest modern approach.

Shows a complete Gulp task that minifies all CSS files using gulp-crass-minifier with default options.

const gulp = require('gulp'); const crass = require('gulp-crass-minifier'); gulp.task('minify-css', () => { return gulp.src('src/**/*.css') .pipe(crass({ optimize: true, pretty: false })) .pipe(gulp.dest('dist')); }); exports.default = gulp.series('minify-css');

Debug

Known issues

gotchagulp-crass-minifier uses Crass which has a known security vulnerability (https://github.com/mattbasta/crass/issues/77). Do NOT use this plugin in production environments.

fix

Use the plugin only for development builds. For production, switch to a safer minifier like cssnano or clean-css.

affects: >=1.0.0

gotchaThe plugin does not include any automated tests; behavior may be unstable or break with updates.

fix

Test your CSS output manually after each upgrade. Consider writing your own tests or use a more robust plugin.

affects: >=1.0.0

gotchaCrass optimization can be very slow on large CSS files; set o1: false to reduce time if needed.

fix

Disable advanced optimizations: pipe(crass({ o1: false })).

affects: >=1.0.0

deprecatedNode.js >=10.16.0 required; older versions are not supported and may fail.

fix

Upgrade Node.js to a version >=10.16.0.

affects: >=1.0.0

breakingNo breaking changes documented; but the underlying Crass library may introduce breaking changes in CSS output format.

fix

Pin the exact version of gulp-crass-minifier and crass in your package.json to avoid unexpected output differences.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'crass'

gulp-crass-minifier depends on crass, which must be installed as an explicit dependency.

fix

Run 'npm install crass --save-dev' if it is not automatically installed.

TypeError: crass is not a function

Using the import incorrectly; the package exports a function directly, not as a default export.

fix

Use: const crass = require('gulp-crass-minifier'); then .pipe(crass()).

Gulpfile: 'default' task not found

The gulpfile uses commonjs but may be interpreted as ESM if package.json has 'type': 'module'.

fix

Remove 'type': 'module' from package.json or rename Gulpfile to .cjs.

Unhandled promise rejection: Error: Crass parse error

Crass cannot parse certain CSS files, e.g., with invalid syntax or unsupported features.

fix

Check the CSS file for errors, or use a more forgiving minifier like clean-css.

Upgrade

Version history

1.0.0latest on npm

Audit

Dependencies

gulprequiredPeer dependency required to use as a Gulp plugin; must be installed separately.

crassrequiredCore library for CSS optimization; bundled via npm but carries security vulnerability.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/tiritto/gulp-crass-minifier ↗

packagegulp-crass-minifier ↗

homepagehttps://github.com/tiritto/gulp-crass-minifier#readme ↗