Add a git package in the Unity Package Manager with target:

https://github.com/arfinity-io/unity-sassimporter.git?path=/Package#v1.1.1

Add package with openupm-cli

npx openupm-cli add io.arfinity.unity.packages.sassimporter

To use this package simply add it in the Unity Package Manager. Scss files are then automatically imported and available as UIToolkit stylesheets.

Make sure you have a Sass compiler locally installed. E.g., for Dart Sass, you can install it as a standalone version on

• Windows with Chocolatey

   choco install sass
  

• MacOS with Homebrew

   brew install sass/sass/sass
  

You can also install a Javascript implementation of Sass using Node

npm install -g sass

though this is said to be less performant.

The importer reads SCSS files such that they can be referenced like USS files. Make sure that you only use USS-supported properties, units, and queries in the SCSS code.

SCSS files starting with an underscore are ignored.

If you don't want to install sass locally on any machine that builds/imports this project there is an optional package 'io.arfinity.unity.packages.sassexecutables' that ships the sass executables for Linux/MacOS/Windows.