How to install dotnet and the Sfumato CLI tool.
Sfumato is written in high performance C# code, and is deployed as a binary for Linux, macOS, and Windows. It natively supports x64 and Arm64 processors.
Installing Sfumato is an easy 2-step process, and only has to be done once:
Sfumato requires that you already have the Microsoft .NET 10.0 runtime installed, which you can get at:
Look for the section titled ".NET Runtime 10.0.x" with various platform download links. Download the one appropriate for your device (Linux, macOS, Windows) and run the installer.
OPTIONAL: If you're running macOS and have Homebrew installed, you can get it that way as well. This installs the latest version:
Run the following command in your command line interface (e.g. cmd, PowerShell, Terminal, bash, etc.):
After installation open a command/terminal shell and run the Sfumato command. You should see the Sfumato help displayed.
If you don't see the Sfumato help displayed, or otherwise get a response that the sfumato command was not found or is invalid, you may need to restart your terminal or device. This is because the system path may not be updated.
You can check for and install updates to Sfumato with the following command:
If you need to completely uninstall Sfumato, use the command below:
You may also want to uninstall the .NET runtime if you won't be using it. Follow Microsoft's instructions:
https://learn.microsoft.com/en-us/dotnet/core/install/remove-runtime-sdk-versions
If you'd prefer to embed Sfumato into a compatible .NET project to have it generate CSS as you work or when you publish, navigate to your project folder and execute the command below to add the nuget package to your project.
This will not work in a Blazor WebAssembly (WASM) project because it runs entirely in the client browser. You can create a separate ASP.NET host project and use it there, or just use the CLI tool.
You can also find and add the package to your project from within Visual Studio, JetBrains Rider, etc. as you would any other package.
Visit the usage section to see how to configure Sfumato after adding the package.
