postcss(1)

Command-line client for node??-postcss

Section 1 node-postcss-cli bookworm source

Description

POSTCSS

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