readme, badges

Author: zoubin

.coveralls.yml

@@ -0,0 +1,2 @@
+service_name: travis-pro
+repo_token: KfDtZaE5IHPtRZVkKP2Mw9BmYRo5yZ0dg

.travis.yml

@@ -1,5 +1,6 @@
 language: node_js
 node_js:
+  - "5"
   - "4"
   - "0.12"
   - "0.11"

README.md

@@ -1,2 +1,129 @@
 # reduce-postcss
 Plugin for [reduce-css](https://github.com/zoubin/reduce-css) to pack postcss modules.
+
+[![npm](https://nodei.co/npm/reduce-css-postcss.png?downloads=true)](https://www.npmjs.org/package/reduce-css-postcss)
+
+[![version](https://img.shields.io/npm/v/reduce-css-postcss.svg)](https://www.npmjs.org/package/reduce-css-postcss)
+[![status](https://travis-ci.org/zoubin/reduce-css-postcss.svg?branch=master)](https://travis-ci.org/zoubin/reduce-css-postcss)
+[![coverage](https://img.shields.io/coveralls/zoubin/reduce-css-postcss.svg)](https://coveralls.io/github/zoubin/reduce-css-postcss)
+[![dependencies](https://david-dm.org/zoubin/reduce-css-postcss.svg)](https://david-dm.org/zoubin/reduce-css-postcss)
+[![devDependencies](https://david-dm.org/zoubin/reduce-css-postcss/dev-status.svg)](https://david-dm.org/zoubin/reduce-css-postcss#info=devDependencies)
+
+## Example
+
+See files in the example directory.
+
+```javascript
+var gulp = require('gulp')
+var del = require('del')
+var reduce = require('reduce-css')
+var postcss = require('reduce-css-postcss')
+var path = require('path')
+var fixtures = path.resolve.bind(path)
+
+gulp.task('clean', function () {
+  return del('build')
+})
+
+gulp.task('single-bundle', ['clean'], function () {
+  return reduce
+    .on('error', console.log.bind(console))
+    .on('log', console.log.bind(console))
+    .on('instance', function (b) {
+      b.plugin(postcss)
+    })
+    .src('*.css', {
+      basedir: fixtures('src'),
+      factor: 'common.css',
+    })
+    .pipe(reduce.dest('build', null, {
+      maxSize: 0,
+      assetOutFolder: fixtures('build', 'images'),
+    }))
+})
+
+gulp.task('watch-single-bundle', ['clean'], function () {
+  reduce.watch()
+    .on('error', console.log.bind(console))
+    .on('log', console.log.bind(console))
+    .on('instance', function (b) {
+      b.plugin(postcss)
+    })
+    .src('*.css', {
+      basedir: fixtures('src'),
+      factor: 'common.css',
+    })
+    .pipe(reduce.dest, 'build', null, {
+      maxSize: 0,
+      assetOutFolder: fixtures('build', 'images'),
+    })
+})
+
+gulp.task('multiple-bundles', ['clean'], function () {
+  return reduce
+    .on('error', console.log.bind(console))
+    .on('log', console.log.bind(console))
+    .on('instance', function (b) {
+      b.plugin(postcss)
+    })
+    .src('*.css', {
+      basedir: fixtures('src'),
+      factor: {
+        needFactor: true,
+        common: 'common.css',
+      },
+    })
+    .pipe(reduce.dest('build', null, {
+      maxSize: 0,
+      useHash: true,
+      assetOutFolder: fixtures('build', 'images'),
+    }))
+})
+
+gulp.task('watch-multiple-bundles', ['clean'], function () {
+  reduce.watch()
+    .on('error', console.log.bind(console))
+    .on('log', console.log.bind(console))
+    .on('instance', function (b) {
+      b.plugin(postcss)
+    })
+    .src('*.css', {
+      basedir: fixtures('src'),
+      factor: {
+        needFactor: true,
+        common: 'common.css',
+      },
+    })
+    .pipe(reduce.dest, 'build', null, {
+      maxSize: 0,
+      useHash: true,
+      assetOutFolder: fixtures('build', 'images'),
+    })
+})
+
+
+```
+
+## options
+
+### processorFilter
+Type: `Function`
+
+Receive a [pipeline](https://github.com/zoubin/postcss-processor-splicer) instance,
+through which you can add, remove, or customize postcss plugins to apply.
+
+Type: `Array`
+
+Specify extra postcss plugins to apply.
+
+#### Default plugins
+
+* [postcss-simple-import](https://github.com/zoubin/postcss-simple-import)
+* [postcss-custom-url](https://github.com/zoubin/postcss-custom-url)
+* [postcss-advanced-variables](https://github.com/jonathantneal/postcss-advanced-variables)
+* [postcss-mixins](https://github.com/postcss/postcss-mixins)
+* [postcss-nested](https://github.com/postcss/postcss-nested)
+* [postcss-extend](https://github.com/travco/postcss-extend)
+* [autoprefixer](https://github.com/postcss/autoprefixer)
+
+