table of contents
| POSTCSS(1) | User Commands | POSTCSS(1) |
NAME¶
postcss - Command-line client for node??-postcss
DESCRIPTION¶
Usage:¶
- postcss [input.css] [OPTIONS] [-o|--output output.css] [--watch|-w] postcss <input.css>... [OPTIONS] --dir <output-directory> [--watch|-w] postcss <input-directory> [OPTIONS] --dir <output-directory> [--watch|-w] postcss <input-glob-pattern> [OPTIONS] --dir <output-directory> [--watch|-w] postcss <input.css>... [OPTIONS] --replace
Basic options:¶
- -o, --output
- Output file [string]
- -d, --dir
- Output directory [string]
- -r, --replace
- Replace (overwrite) the input file [boolean]
- -m, --map
- Create an external sourcemap
- --no-map
- Disable the default inline sourcemaps
- -w, --watch
- Watch files for changes and recompile as needed [boolean]
- --verbose
- Be verbose [boolean]
- --env
- A shortcut for setting NODE_ENV [string]
Options for use without a config file:¶
- -u, --use
- List of postcss plugins to use [array]
- --parser
- Custom postcss parser [string]
- --stringifier
- Custom postcss stringifier [string]
- --syntax
- Custom postcss syntax [string]
Options for use with --dir:¶
- --ext
- Override the output file extension; for use with --dir [string]
- --base
- Mirror the directory structure relative to this path in the output
- directory, for use with --dir
- [string]
Advanced options:¶
- --include-dotfiles
- Enable glob to match files/dirs that begin with "." [boolean]
- --poll
- Use polling for file watching. Can optionally pass pol ling interval; default 100 ms
- --config
- Set a custom directory to look for a config file [string]
OPTIONS¶
- --version
- Show version number [boolean]
- -h, --help
- Show help [boolean]
EXAMPLES¶
- postcss input.css -o output.css
- Basic usage
- postcss src/**/*.css --base src --dir bu
- Glob Pattern & output
- ild cat input.css | postcss -u autoprefixer Piping input & output > output.css
If no input files are passed, it reads from stdin. If neither -o, --dir, or --re place is passed, it writes to stdout.
If there are multiple input files, the --dir or --replace option must be passed.
Input files may contain globs (e.g. src/**/*.css). If you pass an input director y, it will process all files in the directory and any subdirectories, respecting
- the glob pattern.
For more details, please see https://github.com/postcss/postcss-cli
| November 2024 | postcss 16.2.0 |