Minify CSS with CSSO.
Branch: master
Clone or download
Latest commit 9d07cc6 Jan 5, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
test Add source map support (fixes #4) Feb 29, 2016
.editorconfig Adds JSHint & editorconfig. Jan 4, 2014
.gitignore Initial commit. Dec 5, 2013
.jshintrc Tidy up. Oct 17, 2015
.travis.yml Add source map support (fixes #4) Feb 29, 2016
CHANGELOG.md Update changelog Jan 2, 2018
LICENSE-MIT Tidy up. Oct 17, 2015
README.md Tweaks. Apr 9, 2016
index.js Drop dependency on deprecated `gulp-util` (#31) Jan 2, 2018
package.json 3.0.1 Jan 5, 2018
test.js Drop dependency on deprecated `gulp-util` (#31) Jan 2, 2018

README.md

gulp-csso Build Status NPM version Dependency Status

Minify CSS with CSSO.

If you have any difficulties with the output of this plugin, please use the CSSO tracker.

Install

With npm do:

npm install gulp-csso --save-dev

Example

var gulp = require('gulp');
var csso = require('gulp-csso');

gulp.task('default', function () {
    return gulp.src('./main.css')
        .pipe(csso())
        .pipe(gulp.dest('./out'));
});

gulp.task('development', function () {
    return gulp.src('./main.css')
        .pipe(csso({
            restructure: false,
            sourceMap: true,
            debug: true
        }))
        .pipe(gulp.dest('./out'));
});

API

csso([options])

options

For backwards compatibility it can also be a boolean. In this case, the inverted value is set to options.restructure (e.g. true becomes {restructure: false}).

restructure

Type: boolean
Default: true

The default is to use structure minimization for maximum compression. Pass false instead if you want to disable this feature.

sourceMap

Type: boolean
Default: depends on input file has a source map or not

Specify this to generate source map; by default a source map is generated only if the input file has a source map. Pass true to ensure that the source map is generated or false to disable this.

Alternatively, you can enable source maps support using gulp-sourcemaps:

var gulp = require('gulp');
var csso = require('gulp-csso');
var sourcemaps = require('gulp-sourcemaps');

gulp.task('default', function () {
    return gulp.src('main.css')
        .pipe(sourcemaps.init())
        .pipe(csso())
        .pipe(sourcemaps.write('.'))
        .pipe(gulp.dest('./out'));
});
debug

Type: boolean
Default: false

Pass true or a positive number (greater number for more details) to get some debugging information about the minification process.

usage

Type: object Default: null

Usage data for advanced optimisations (read more in the CSSO documentation).

Contributing

Pull requests are welcome. If you add functionality, then please add unit tests to cover it.

License

MIT © Ben Briggs