stylus

Compile Stylus file to CSS

$ stylus [style.styl]

$ stylus [style.styl] -o [style.css]

$ stylus -w [style.styl] -o [style.css]

$ stylus -c [style.styl]

$ stylus [src/] -o [dist/]

$ stylus --css [style.css] [style.styl]

$ stylus --sourcemap [style.styl]

stylus [options] [file|dir...]

stylus is a command-line compiler for the Stylus CSS preprocessor. Stylus is an expressive, dynamic CSS language built for Node.js that features flexible syntax, powerful functions, and robust feature set.
The compiler transforms Stylus source files (.styl) into standard CSS. Stylus syntax is flexible, allowing optional colons, semicolons, and braces, making stylesheets more readable. It supports variables, mixins, functions, iteration, and many other features that extend CSS capabilities.
The watch mode enables automatic recompilation during development. Source maps aid debugging by mapping compiled CSS back to original Stylus sources. The CSS conversion feature helps migrate existing stylesheets to Stylus.

-o, --out dir

Output to specified directory or file.

Watch files for changes and recompile.

Compress CSS output.

Convert CSS to Stylus format.

Generate source map files.

Add line number comments to output.

Start interactive REPL.

Inline images as data URIs.

Use specified plugin.

Add path to import lookup.

Import file before compiling.

Print compiled CSS to stdout.

Add vendor prefixes.

Display version.

Display help.

Requires Node.js and npm for installation. The flexible syntax can be confusing for teams without consistent conventions. Performance may be slower than other preprocessors for large projects. Stylus has less community adoption compared to Sass/SCSS.

Stylus was created by TJ Holowaychuk (creator of Express.js) and released in 2010. It was designed to be more expressive and flexible than existing CSS preprocessors. While it gained significant adoption, Sass/SCSS eventually became more dominant in the CSS preprocessor ecosystem.

sass(1), less(1), postcss(1), npm(1)