From a6c318cb5e614d7cbea5161601b7ca8175b19f5f Mon Sep 17 00:00:00 2001
From: Stephan van Leeuwen <stephan.vanleeuwen5@gmail.com>
Date: Wed, 6 May 2026 18:47:15 +0200
Subject: [PATCH] Allow disabling the sass compile on build task via a MSBuild
 property

Fixes #246
---
 .../build/AspNetCore.SassCompiler.props               |  2 ++
 .../build/AspNetCore.SassCompiler.targets             |  2 +-
 README.md                                             | 11 +++++++++++
 3 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/AspNetCore.SassCompiler/build/AspNetCore.SassCompiler.props b/AspNetCore.SassCompiler/build/AspNetCore.SassCompiler.props
index 0ed6dba..4057738 100644
--- a/AspNetCore.SassCompiler/build/AspNetCore.SassCompiler.props
+++ b/AspNetCore.SassCompiler/build/AspNetCore.SassCompiler.props
@@ -29,6 +29,8 @@
     <SassCompilerEnableWatcher Condition="'$(SassCompilerEnableWatcher)' == '' AND '$(Configuration)' == 'Release'">false</SassCompilerEnableWatcher>
     <SassCompilerEnableWatcher Condition="'$(SassCompilerEnableWatcher)' == '' AND '$(OutputType)' == 'Library'">false</SassCompilerEnableWatcher>
 
+    <SassCompilerEnableBuildTask Condition="'$(SassCompilerEnableBuildTask)' == ''">true</SassCompilerEnableBuildTask>
+
     <SassCompilerConfiguration Condition="'$(SassCompilerConfiguration)' == ''">$(Configuration)</SassCompilerConfiguration>
     <SassCompilerConfiguration Condition="'$(SassCompilerConfiguration)' == ''">Debug</SassCompilerConfiguration>
 
diff --git a/AspNetCore.SassCompiler/build/AspNetCore.SassCompiler.targets b/AspNetCore.SassCompiler/build/AspNetCore.SassCompiler.targets
index 86b04aa..90d8d62 100644
--- a/AspNetCore.SassCompiler/build/AspNetCore.SassCompiler.targets
+++ b/AspNetCore.SassCompiler/build/AspNetCore.SassCompiler.targets
@@ -14,7 +14,7 @@
 
   <Target Name="Compile Sass"
           BeforeTargets="Build;ResolveScopedCssInputs;BundleMinify;ResolveProjectStaticWebAssets"
-          Condition="'$(DesignTimeBuild)' != 'true'">
+          Condition="'$(DesignTimeBuild)' != 'true' AND '$(SassCompilerEnableBuildTask)' != 'false'">
     <CompileSass AppsettingsFile="$(SassCompilerAppsettingsJson)"
                  SassCompilerFile="$(SassCompilerSassCompilerJson)"
                  Command="$(SassCompilerBuildCommand)"
diff --git a/README.md b/README.md
index 187e39c..7081e16 100644
--- a/README.md
+++ b/README.md
@@ -128,6 +128,17 @@ have the `ISassCompiler` available, you can use the `AddSassCompilerCore()` meth
 method on the `IServiceCollection`. This will register what is required to use the `ISassCompiler` interface without
 registering the hosted service.
 
+If you are only using `ISassCompiler` at runtime and want to disable the MSBuild compile-on-build task entirely, you can
+add the following property to your `.csproj` file:
+
+```xml
+<PropertyGroup>
+  <SassCompilerEnableBuildTask>false</SassCompilerEnableBuildTask>
+</PropertyGroup>
+```
+
+This prevents the Sass MSBuild task from running during `build` and `publish`, while leaving `ISassCompiler` fully functional at runtime.
+
 ## Publish
 
 This library also includes an MSBuild task that runs during the publish of your application. Because of this you don't need to include