Convert a SCSS or Sass file to CSS and print out the result

$ sass [inputfile.scss|inputfile.sass]

Convert a SCSS or Sass file to CSS and save the result to a file
$ sass [inputfile.scss|inputfile.sass] [outputfile.css]

Watch a SCSS or Sass file for changes and output or update the CSS file with same filename
$ sass --watch [inputfile.scss|inputfile.sass]

Watch a SCSS or Sass file for changes and output or update the CSS file with the given filename
$ sass --watch [inputfile.scss|inputfile.sass]:[outputfile.css]


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 10.

--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.

Copied to clipboard