Sass(1) Sass compiles CSS from SASS or SCSS files


sass [,options/] [,INPUT/] [,OUTPUT/]



Converts SCSS or Sass files to CSS.

Common Options:

-I, --load-path PATH
Specify a Sass import path.
-r, --require LIB
Require a Ruby library before running Sass.
Make Compass imports available and load project configuration.
-t, --style NAME
Output style. Can be nested (default), compact, compressed, or expanded.
-?, -h, --help
Show this help message.
-v, --version
Print the Sass version.

Watching and Updating:

Watch files or directories for changes. The location of the generated CSS can be set using a colon:
sass --watch input.sass:output.css
sass --watch input-dir:output-dir
Check for file changes manually, rather than relying on the OS. Only meaningful for --watch.
Compile files or directories to CSS. Locations are set like --watch.
-f, --force
Recompile every Sass file, even if the CSS file is newer. Only meaningful for --update.
If a file fails to compile, exit immediately. Only meaningful for --watch and --update.

Input and Output:

Use the CSS-superset SCSS syntax.
How to link generated output to the source files. auto (default): relative paths where possible, file URIs elsewhere file: always absolute file URIs inline: include the source text in the sourcemap none: no sourcemaps
-s, --stdin
Read input from standard input instead of an input file. This is the default if no input file is specified.
-E, --default-encoding ENCODING
Specify the default encoding for input files.
Use Unix-style newlines in written files. Always true on Unix.
-g, --debug-info
Emit output that can be used by the FireSass Firebug plugin.
-l, --line-numbers
Emit comments in the generated CSS indicating the corresponding source line.


-i, --interactive
Run an interactive SassScript shell.
-c, --check
Just check syntax, don't evaluate.
--precision NUMBER_OF_DIGITS How many digits of precision to use when outputting decimal numbers.
Defaults to 5.
--cache-location PATH
The path to save parsed Sass files. Defaults to .sass-cache.
-C, --no-cache
Don't cache parsed Sass files.
Show a full Ruby stack trace on error.
-q, --quiet
Silence warnings and status messages during compilation.