MillsSoftware.CoreSassCompiler
1.0.14
See the version list below for details.
dotnet add package MillsSoftware.CoreSassCompiler --version 1.0.14
NuGet\Install-Package MillsSoftware.CoreSassCompiler -Version 1.0.14
<PackageReference Include="MillsSoftware.CoreSassCompiler" Version="1.0.14" />
paket add MillsSoftware.CoreSassCompiler --version 1.0.14
#r "nuget: MillsSoftware.CoreSassCompiler, 1.0.14"
// Install MillsSoftware.CoreSassCompiler as a Cake Addin #addin nuget:?package=MillsSoftware.CoreSassCompiler&version=1.0.14 // Install MillsSoftware.CoreSassCompiler as a Cake Tool #tool nuget:?package=MillsSoftware.CoreSassCompiler&version=1.0.14
Core Sass Compiler
The Basic Idea
.NET Core module to add SASS compilation and minification to any ASP.NET Core project.
How to Install
Install nuget package via GitHub Packages. Note that this package is NOT on the main nuget feed yet.
Add to services via dependency injection (here added to Program.cs in a .NET 6 project):
using MillsSoftware.CoreSassCompiler;
builder.Services.AddCoreSassCompiler(
new SassProfile()
{
Name = "main-css",
Url = "/css/main",
InputFile = Path.Combine(environment.WebRootPath, "scss", "index.scss"),
Minify = true,
CacheMinutes = 1440,
ChangeToken = environment.WebRootFileProvider.Watch("scss/*.scss")
}
);
This sets up a profile that defines what SASS should be compiled (using LibSassHost) and whether it should be minified (using NUglify). The compiled SASS will be cached for the number of minutes specified. The cached compilation has a dependency on the scss/*.scss files
, so editing any of these files results in a new compilation. Note that multiple profiles can be added if necessary.
- Link to the compiled SASS via a tag helper (here added in the _Layout.cshtml):
<sass name="main-css" />
Note that this won't work until you add the following directive to _ViewImports.cshtml
that allows your views to use the new tag helper:
@addTagHelper *, MillsSoftware.CoreSassCompiler
The end result in your rendered layout is a standard link tag with a hash based on the file content:
<link rel="stylesheet" href="/css/main?UeBVvswRn5/Iod8IXrQ61A==" />
- Add a controller to render the CSS:
using Microsoft.AspNetCore.Mvc;
using MillsSoftware.CoreSassCompiler;
namespace MySite.Controllers
{
[Route("css")]
public class CssController : Controller
{
private readonly SassCompiler _compiler;
private readonly IWebHostEnvironment _environment;
public CssController(SassCompiler compiler, IWebHostEnvironment environment)
{
_compiler = compiler;
_environment = environment;
}
[HttpGet("main")]
public IActionResult Main()
{
var compilation = _compiler.GetCompilation("main-css");
if (compilation == null) return NotFound();
if (!compilation.IsSuccess && _environment.IsDevelopment())
{
return Content($"{compilation.SassErrors} {compilation.MinifierErrors}");
}
return Content(compilation.SassResult ?? "", "text/css");
}
}
}
Future Changes
Add to the main nuget package feed.
Set up an automatic controller to return the CSS. This would eliminate step 4 above, but would potential not give you as much control over the output (e.g. what to do when the compilation fails).
Add HTTP cache headers to the CSS output.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net6.0
- LibSassHost (>= 1.3.3)
- LibSassHost.Native.win-x64 (>= 1.3.3)
- Microsoft.AspNetCore.Razor (>= 2.2.0)
- Microsoft.Extensions.Caching.Memory (>= 6.0.1)
- Microsoft.Extensions.Logging (>= 6.0.0)
- NUglify (>= 1.20.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.