PlayNicely.Sass 1.4.0

Play Nicely - Sass

CSS is great but it does have its limitations, Sass is awesome but how do I get it to compile in my .NET project? That is the question that Play Nicely is here to answer.

This package adds npx package execution support for the (npm) sass transpiler into any .NET project.

Installation

Simply install this package into your project like any other NuGet dependency.

Install-Package PlayNicely.Sass

Getting Started

We recommend creating a node package, and adding sass as a dependency, before installing this package.

npm init -y
npm install sass

Once the sass npm package is installed, add this package as a dependency to the project (see Installation section).

That's it, this package will include any *.scss or *.sass files for transpilation, by default any file prefixed with _ (underscore) will not be transpiled, per sass' partial rules.

Configuration

By default, any *.sass or *.scss file will be transpiled. If the build property <SassIncludeDefaultItems/> is set to false, then you have to explicitly add <Sass Include="_your_file"/> items to your project.

Also by default, the sass source files and any .css.map files will be excluded from the published output. There are two ways to change this behaviour.

If you set property <SassPublishSource/> to true, then all sass source files and .css.map files will be published.

For more fine grained control, You can update specific <Sass/> items, set their metadata <PublishSource/> to true and the source and .css.map for that file will be published.