Stylus documentation: http://learnboost.github.io/stylus/

Stylus tutorial: http://learnboost.github.io/stylus/try.html

What is Stylus

Stylus is a CSS pre-processor, that runs in node.js or even a web browser.

Why Use a CSS pre-processor

• Easier to maintain
  • reduces duplication (e.g. variables, mixins, functions, and  etc)
  • improved organization

Why Stylus

• Runs in node.js
• Rich functionality
• Flexible syntax

Stylus convention for Infusion

• Keep colons, semi-colons and brackets (for readability)

How to prevent grunt from compiling utility Stylus files

Utility Stylus files only contain mixins or functions for other Stylus files to import. Utility files should not be compiled down to CSS, to prevent the grunt task `grunt buildStylus` from compiling them, place these files in a "utils" directory. This is an example of the utility directory.

Steps to convert an infusion CSS to Stylus

• Create a "stylus" directory inside of the modules css directory and place all stylus files in the "stylus" directory
• If utility Stylus files are needed, create a "utils" sub-directory within the "stylus" directory and place the utils files within
• To compile to CSS, from the command line run grunt buildStylus. This will place the compiled CSS files directly in the parent css directory
  
  Example Structure

• component
  • css
    • stylus
      • utils

To be converted