LibSassBuilder 1.6.1

LibSassBuilder

Inspired by Delegate.SassBuilder and LibSassHost

Build	NuGet Package	.NET Global Tool

Nuget Package

LibSassBuilder NuGet package adds a build task to compile Sass files to .css. It's compatible with both MSBuild (VS) and dotnet build.

No configuration is required, it will compile the files implicitly on project build.

• Optionally provide arguments (see Options below):

<PropertyGroup>
  
  <LibSassOutputStyle>compressed</LibSassOutputStyle>
  <LibSassOutputStyle Condition="'$(Configuration)' == 'Debug'">expanded</LibSassOutputStyle>
  
  <LibSassOutputLevel>verbose</LibSassOutputLevel>
  
  <LibSassMessageLevel>High</LibSassMessageLevel>
</PropertyGroup>

• Or take control of what files to process

<PropertyGroup>
  
  <EnableDefaultSassItems>false</EnableDefaultSassItems>  
</PropertyGroup>

<ItemGroup>
  
  <SassFile Include="Vendor/**/*.scss" > 
  <SassFile Include="Styles/**/*.scss" Exclude="Styles/unused/**" />
</ItemGroup>

• Or ignore all previous options (except for <LibSassMessageLevel>) and determine the arguments to the tool yourself

<PropertyGroup>
  
  <LibSassBuilderArgs>directory "$(MSBuildProjectDirectory)"</LibSassBuilderArgs>
  
  <LibSassMessageLevel>High</LibSassMessageLevel>
</PropertyGroup>

.NET Global Tool

Install:

dotnet tool install --global LibSassBuilder-Tool

Use:

lsb [optional-path] [options]
lsb help
lsb help directory
lsb help files

Generic options

-l, --level      Specify the level of output (silent, default, verbose)

--outputstyle    Specify the style of output (compressed, condensed, nested, expanded)

Directory command (default)

Scans a directory recursively to generate .css files

-e, --exclude    (Default: bin obj logs node_modules) Specify explicit directories to exclude. Overrides the default.

--help           Display this help screen.

--version        Display version information.

value pos. 0     Directory in which to run. Defaults to current directory.

Example:

lsb directory
lsb directory sources/styles -e node_modules
lsb directory sources/styles -e node_modules -l verbose

Files in the following directories are excluded by default:

• bin
• obj
• logs
• node_modules

Files command (default)

Processes the files given on the commandline

--help           Display this help screen.

--version        Display version information.

value pos. 0     File(s) to process.

Example:

lsb files sources/style/a.scss sources/vendor/b.scss
lsb files sources/style/a.scss sources/vendor/b.scss -l verbose

Bypass Visual Studio fast up to date check

Visual Studio does a quick check to find changed files. However if you edit the sass files, it does not see these as project changes.
If you edit sass files a lot, you can instruct Visual Studio to rely on MSBuild by placing the following property in your .csproj.

<PropertyGroup>
    <DisableFastUpToDateCheck>true</DisableFastUpToDateCheck>
</PropertyGroup>

The NuGet package also includes the custom files list to watch to track sass files with dotnet watch by default.

Requirements

LibSassBuilder can be installed on any project, however the underlying build tool requires .NET 5 installed on the machine.

Support

The support is largely dependant on LibSassHost

This tool contains the following supporting packages:

• LibSassHost.Native.win-x64
• LibSassHost.Native.linux-x64
• LibSassHost.Native.osx-x64

Package as nuget package

./package.ps1 -PackageDir 'C:/LocalPackages' -Version '1.4.0.1'