Scroll to navigation

RUBY(1) User Commands RUBY(1)


Ruby - Sass compiles CSS from SASS files


sass [options] [INPUT] [OUTPUT]



Converts SCSS or Sass files to CSS.

Common Options:

Specify a Sass import path.
Require a Ruby library before running Sass.
Make Compass imports available and load project configuration.
Output style. Can be nested (default), compact, compressed, or expanded.
-?, -h, --help
Show this help message.
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-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.
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
Read input from standard input instead of an input file. This is the default if no input file is specified.
Specify the default encoding for input files.
Use Unix-style newlines in written files. Always true on Unix.
Emit output that can be used by the FireSass Firebug plugin.
Emit comments in the generated CSS indicating the corresponding source line.



Run an interactive SassScript shell.
Just check syntax, don't evaluate.
Defaults to 10.
The path to save parsed Sass files. Defaults to .sass-cache.
Don't cache parsed Sass files.
Show a full Ruby stack trace on error.
Silence warnings and status messages during compilation.
November 2021 Ruby Sass 3.7.4