gulp-purgecss
Version:
Gulp plugin for purgecss
71 lines (51 loc) • 2.69 kB
Markdown
# gulp-purgecss
[](https://travis-ci.org/FullHuman/gulp-purgecss)
[]()
[]()
[]()
[](https://www.codacy.com/app/FullHuman/gulp-purgecss?utm_source=github.com&utm_medium=referral&utm_content=FullHuman/gulp-purgecss&utm_campaign=Badge_Grade)
[](https://github.com/prettier/prettier)
[](https://www.npmjs.com/package/gulp-purgecss)
[]() [](https://greenkeeper.io/)
> [gulp](http://gulpjs.com/) plugin to removed unused CSS, using [purgecss](https://github.com/FullHuman/purgecss)
## Regarding Issues
This is just a simple [gulp](https://github.com/gulpjs/gulp) plugin, which means it's nothing more than a thin wrapper around `purgecss`. If it looks like you are having CSS related issues, please go to the [purgecss](https://github.com/FullHuman/purgecss/issues) repo. Only create a new issue if it looks like you're having a problem with the plugin itself.
## Install
```
npm i -D gulp-purgecss
npm install --save-dev gulp-purgecss
```
## Usage
By default, `purgecss` outputs the source CSS _with unused selectors removed_:
```js
const gulp = require('gulp')
const purgecss = require('gulp-purgecss')
gulp.task('purgecss', () => {
return gulp.src('src/**/*.css')
.pipe(purgecss({
content: ['src/**/*.html']
}))
.pipe(gulp.dest('build/css'))
})
```
By setting the `rejected` option, you can 'invert' the output to list _only the removed selectors_:
```js
const gulp = require('gulp')
const rename = require('gulp-rename')
const purgecss = require('gulp-purgecss')
gulp.task('purgecss-rejected', () => {
return gulp.src('src/**/*.css')
.pipe(rename({
suffix: '.rejected'
})
.pipe(purgecss({
content: ['src/**/*.html'],
rejected: true
}))
.pipe(gulp.dest('build/css'))
})
```
## Versioning
We use [SemVer](http://semver.org/) for versioning.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details