---
name: "postcss"
section: "1"
platform: "linux"
package: "node-postcss-cli"
version: "10.1.0+~cs16.11.1-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/postcss"
---

# postcss(1)

Command-line client for node??-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