Home

Awesome

mimosa-sass

Overview

This is a SASS compiler for the Mimosa build tool.

You can use this module for both Ruby SASS and node-sass.

For more information regarding Mimosa, see http://mimosa.io

Note: Using version 3.0+ of the node-sass compiler requires 3.0+ of this module.

Usage

Add 'sass' to your list of modules. That's all! Mimosa will install the module for you when you start mimosa watch or mimosa build.

Functionality

This module will compile SASS files during mimosa watch and mimosa build and includes compilation with compass.

For SASS compilation there are two compiling options, using Ruby SASS (SASS Ruby gem install) or node.js SASS (via the node-sass library).

Ruby

Ruby is SASS' source language and the node.js version is a port of the Ruby functionality to node.js.

node-sass

This module does not come bundled with the node.js version as it can occasionally cause installation issues, but this module is ready to use the node version if it is provided. Use the lib setting to provide a node-sass compiler. (Ex: lib: require('node-sass')). By default the Ruby version is enabled, but if lib is provided, node-sass will be used.

Compass

Compass (Ruby install) does not have a node.js port, so to use SASS and Compass together, Ruby SASS must be used.

Source Maps

If using node-sass, this module includes support for inline (dynamic) source maps. Source maps will be created for your compiled sass file and included at the bottom of the compiled CSS. This is enabled by default for mimosa watch. mimosa build is presumed to not be a dev time task, therefore source maps are disabled.

Default Config

sass: {
  sourceMap: true,
  lib: undefined,
  extensions: ["sass", "scss"],
  includePaths: []
}