POSTCSS(1)

📦
version 10.1.0+~cs16.11.1 · 2 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

💖 POSTCSS 💖

okay bestie, gather round, because postcss is literally the command-line client for node??-postcss and it's giving main character energy from the very first flag. 🌈✨

🦋 DESCRIPTION 🦋

the usage, bestie</p>

fr fr, here's how you call on it:

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

like. five whole ways to show up. pick your vibe. 👑

✨ Basic options ✨

  • -o, --output — the output file. that's it, that's the whole job. [string] 🎀
  • -d, --dir — the output directory, sis. plural energy. [string]
  • -r, --replace — replace (overwrite) the input file. yes, overwrite, like it said. [boolean] 😭
  • -m, --map — make an external sourcemap. fancy map, outside the file. 🗺️
  • --no-map — turn off the default inline sourcemaps. not me disabling the default… 🙈
  • -w, --watch — watch the files for changes and recompile whenever they need it. it's giving devoted. [boolean] 👀
  • --verbose — be verbose. spill the tea, bestie. [boolean] 💬
  • --env — a shortcut for setting NODE_ENV. [string] 🌱

🧚 Options for use without a config file 🧚

  • -u, --use — a 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 ".". yes, the sneaky ones. [boolean]
  • --poll — use polling for file watching. you can optionally pass a polling interval; default 100 ms. ⏱️
  • --config — set a custom directory to look for a config file. [string] 🗂️

🌸 OPTIONS 🌸

lowkey these two are the homies you'll use every single time:

  • --version — show version number. [boolean] 📌
  • -h, --help — show help. your emergency bestie. [boolean] 🆘

🔥 EXAMPLES 🔥

basic usage, periodt

postcss input.css -o output.css

glob pattern & output 🦋

postcss src/**/*.css --base src --dir build

piping input & output 🍓

cat input.css | postcss -u autoprefixer > output.css

💜 the important little notes 💜

so if no input files are passed, it reads from stdin. and if neither -o, --dir, or --replace is passed, it writes to stdout. no cap. 🫶

if there are multiple input files, you must pass the --dir or the --replace option. like, non-negotiable bestie. 🤨

input files may contain globs (e.g. src/**/*.css). and if you pass an input directory, it will process all files in the directory and any subdirectories, respecting the glob pattern. it's thorough like that. 💅

for more details, please see https://github.com/postcss/postcss-cli ⭐

okay that's the whole manual, you're basically a postcss girlie now. go compile something iconic. 🧚‍♀️

this has been postcss 16.2.0, from November 2024 💖 mwah, bye bestie, see u at the next build 🎀

📦 where this page comes from