Usage

This ColdBox Elixir extension allows you to compile Stylus.

Installation

First, pull in the extension through NPM.

npm install --save-dev coldbox-elixir-stylus

That's it! You're all set to go!

Usage

Assuming you write...

elixir( function( mix ) {
   mix.stylus( "app.styl" );
} );

...this will compile your resources/assets/stylus/app.styl file to ./includes/css/app.css.

If you'd like to set a different output directory, you may pass a second argument to the stylus() method, like so:

mix.stylus( "app.styl", "./public/scripts/styles.css" );

Finally, if you want to override the Stylus plugin options, you may pass an object as the third argument.

mix.stylus( "app.styl", null, {} );

// See options at: https://www.npmjs.com/package/gulp-stylus#options

PostCSS

This extension includes a PostCSS adapter out of the box, as well as support for the incredibly impressive Lost grid system. Check out the documentation in that link, and immediately start using it in your projects with this extension. Zero setup. :)

If there are other PostCSS plugins you want to pull in, you may use the third argument to mix.stylus()

var postStylus = require( "poststylus" ); // npm install poststylus --save-dev

mix.stylus( "app.styl", null, {
   use: [ postStylus( [ "lost", "postcss-position" ] ) ]
} );