Skip to content

A postcss cli build tool. Useful if you use npm as a build tool.

Notifications You must be signed in to change notification settings

otissv/postcss-build

Repository files navigation

#PostCSS Build A postcss cli build tool. Useful if you use npm as a build tool. As opposed to postcss-cli, PostCSS build can scan an entire directory and subdirectory for files as well as process files in sequence.

Usage

PostCSS Build takes a number of source files and passes them through PostCSS and outputs a single file.

$ npm install -g postcss-build --save-dev

$ postcssbuild --src main.css --output main.min.css --plugins [ "autoprefixer", "cssnano" ]

CLI options

-c or --config
Configuration file in JSON or CommonJS.

-d or --dir
Source directory as string or directories as array. This is recursive.

-e or --ext When in dir mode, will only process file extensions specified. Defaults to ".css".

-h or --help
Displays help text .

-n or --notify
Show os notifications.

-o or --output
Path to output file.

-p or --plugins
Array of postcss plugins names.

-s or --src
Path to a single source file or a list of arrays and strings with source file paths, where they will be processed in sequence. --src overrules --dir.

-t or --options
Plugin options.

-w or --watch Recursively watch a directory for changes.

Config

Instead of passing arguments via the cli they can be placed inside a JSON config file.

CLI arguments overrule config.

Example

module.exports = {
	"notify" : true,

	"ext": ".css",

	"watch" : "example/src/",

	"src": [
		"example/src/main.css",
		[
			"example/src/about/about1.css",
			"example/src/about/about2.css"
		],
		[
			"example/src/home/home1.css",
			"example/src/home/home2.css"
		],
		"example/src/content.css",
	],

	"output": "example/css/main.min.css",

	"plugins": [
	"autoprefixer",
	"precss",
	// "cssnano"
	],

	"options": {
		"autoprefixer": {
			"browsers": ["> 1%", "IE 7"],
			"cascade": false
		},

		"cssnano": { "safe": true }
	}
};

Example

npm start

Change Log

All notable changes to this project will be documented in CHANGELOG.md.

This project adheres to Semantic Versioning.

{
  "version": "1.1.0"
}

MAJOR.MINOR.PATCH

  1. MAJOR: Breaking changes.
  2. MINOR: New features.
  3. PATCH: Bug fixes.

Credits

postcss

##License MIT

About

A postcss cli build tool. Useful if you use npm as a build tool.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published