ColdBox Elixir Stylus Extension
Clone or download
Pull request Compare This branch is 4 commits ahead, 2 commits behind JeffreyWay:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
index.js
package.json
readme.md

readme.md

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

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.