AspNetCore.SassCompiler

Sass Compiler Library for .NET Core 3.1/5.x./6.x without node.

Installation

The installation of this package is quite simple, you can install this package using NuGet with the following command:

# Package Manager PM> Install-Package AspNetCore.SassCompiler # .NET CLI dotnet add package AspNetCore.SassCompiler

Configuration

After adding the package, the Sass styles from the SourceFolder (defaults to: Styles) will automatically be compiled into .css files in the TargetFolder (defaults to: wwwroot\css) on build. You can also adjust the default (--style=compressed --error-css --no-source-map) dart-sass Arguments in the appsettings.json or sasscompiler.json. Scoped CSS is also supported for applications that use blazor for example. This feature is enabled by default and will use the default scoped CSS folders as shown below. To disable this feature, change GenerateScopedCss to false. To adjust any of the default configuration, please add one or more of the following settings to the appsettings.json or sasscompiler.json (when using sasscompiler.json the configuration should not be nested under the key SassCompiler but added directly on the root object):

{ "SassCompiler": { "SourceFolder": "Styles", "TargetFolder": "wwwroot/css", "Arguments": "--style=compressed", "GenerateScopedCss": true, "ScopedCssFolders": ["Views", "Pages", "Shared", "Components"], // You can override specific options based on the build configuration "Configurations": { "Debug": { // These options apply only to Debug builds "Arguments": "--style=expanded" } } } }

Sass watcher

To use the Sass watcher in your project, you must add the following code to your startup.cs:

public void ConfigureServices(IServiceCollection services) { #if DEBUG services.AddSassCompiler(); #endif }

We recommend adding the #if DEBUG statement to only use a watcher during debug mode.