The Grails stylus-asset-pipeline is a plugin that provides Stylus support for the asset-pipeline static asset management plugin. Most of it is copied from the less-asset-pipeline
For more information on how to use asset-pipeline, visit here.
Imports and requires work by simulating Node.js' filesystem, though wildcard support in include names is not (yet) implemented - submit issues (pull requests are even better) if you need this, it shouldn't be too hard to implement. The middleware functions don't work either as they require a functioning Node.js server. As for the rest of Stylus' features, issues and/or pull requests are, again, welcome if you stumble upon errors!
Simply create files in your standard assets/stylesheets folder with extension .styl or .css.styl. You also may require other files by using the following requires syntax at the top of each file:
/*
*= require test
*= require_self
*= require_tree .
*/Including Stylus files into your GSP files is easy but there are a few things worth mentioning. Say we have a file called application.styl. You would include it into your gsp by its compiled extension instead of its original extension. aka, use .css instead of .styl
<head>
<asset:stylesheet src="https://github.com/gregopet/stylus-asset-pipeline/raw/master/application.css"/>
</head>During war build your styl files are compiled into css files. This is all well and good but sometimes you dont want each individual styl file compiled, but rather your main base styl file. It may be best to add a sub folder for those Stylus files and exclude it in your precompile config...
Config.groovy:
grails.assets.excludes = ["mixins/*.styl"]