antons / sass.novaextension

Sass Extension for Nova

Sass Extension for Nova

Converts scss files into css files automatically on save.

Features

• Converts scss files into css files automatically on save
• Automatically create source maps
• Generated css can be compressed or expanded
• Notification of compile errors

Requirements

Before using this extension, you must ensure that sass is installed on your system. One method is using Homebrew.

Sass Insall

1. Install Homebrew.
2. Via Terminal run brew install sass/sass/sass

Extension Installation

1. Open Nova.
2. Choose menu Extensions > Extension Library...
3. Search extension Sass
4. Click Install.

Preferences

Preferences are managed per project, these can be accessed via Project -> Project Settings -> Sass

Enable compile Sass on Save
Enables compile on save for this project.

CSS Style
Expanded, Compressed
Controls the output style of the resulting CSS.

Error CSS
On, Off
Tells Sass whether to emit a CSS file when an error occurs during compilation.

Generate Source Map
External, Internal, Off
Source maps are files that tell browsers or other tools that consume CSS how that CSS corresponds to the Sass files from which it was generated. They make it possible to see and even edit your Sass files in browsers.

Update Path
source/css/
Manually set the path that an update will be performed on, relative to the workspace directory.

Output Path
dist/css/
Manually set the output path of the generated css files, relative to the workspace directory.

Executable Path
/path/to/sass
Manually enter or select the scss binary location.

Notes

• As default the scss processor will compile in the current directory. If the current directory name is scss it will start at the parent. This allows us to use the following directory structure where the combined.scss includes styles from the sub folder:

  project
  project/assets/css
  project/assets/css/combined.css  
  project/assets/css/combined.scss
  project/assets/css/scss
  project/assets/css/scss/_include.scss
  

  If either _include.scss or combined.scss are saved the compiler will run on the directory project/assets/css/