Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
This branch is 4 commits ahead, 2 commits behind JeffreyWay:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


This ColdBox Elixir extension allows you to compile Stylus.


First, pull in the extension through NPM.

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

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


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:


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" ] ) ]
} );

Contributions and Bugs

Project tracking for this project can be found at the Ortus Solutions Jira. Please log all bugs, improvements, and features there.

Pull requests are welcome and encouraged. Please check on the Jira page before starting any large amount of work so your time isn't wasted.

Brad Wood (@bdw429s) has a great guide on submitting pull requests. If you are unsure where to go, in need of help, or have a question, come ask in the #box-products channel on the CFML Slack.


No releases published


No packages published


  • JavaScript 100.0%