NuGet Version License: MPL 2.0

A .NET MSBuild integration package for TailwindCSS that automatically compiles your TailwindCSS files during the build process. This package includes cross-platform TailwindCSS standalone executables and provides seamless integration with .NET projects.

• 🚀 Automatic compilation during MSBuild process
• 📦 No Node.js dependency - uses standalone TailwindCSS CLI
• 🔧 MSBuild integration with customizable properties

Install the NuGet package in your .NET project:

dotnet add package DotnetDevKR.TailwindCSS

You can also install the package from GitHub Packages:

1. Add GitHub Packages as a NuGet source (one time setup):

   dotnet nuget add source https://nuget.pkg.github.com/dotnetdev-kr/index.json \
    --name github \
    --username YOUR_GITHUB_USERNAME \
    --password YOUR_GITHUB_PAT \
    --store-password-in-clear-text

2. Install the package:

   dotnet add package DotnetDevKR.TailwindCSS

Note: You need a GitHub Personal Access Token (PAT) with read:packages scope to install from GitHub Packages.

1. Install the package in your project
2. Create a TailwindCSS input file (e.g., tailwind.css):

   @import "tailwindcss";

3. Configure MSBuild properties in your .csproj file:

   <Target Name="Configure" BeforeTargets="RunTailwindCSSTask">
    <PropertyGroup>
    <InputFilename>$(ProjectDir)tailwind.css</InputFilename>
    <OutputFilename>wwwroot\css\app.css</OutputFilename>
    <IsMinify>false</IsMinify>
    <DebugMode>true</DebugMode>
    </PropertyGroup>
   </Target>

4. Build your project - TailwindCSS will be compiled automatically!

Configure the TailwindCSS compilation by setting these properties in your project file:

<Project Sdk="Microsoft.NET.Sdk.BlazorWebAssembly">
 <PropertyGroup>
 <TargetFramework>net9.0</TargetFramework>
 </PropertyGroup>
 <ItemGroup>
 <PackageReference Include="DotnetDevKR.TailwindCSS" Version="0.0.1" />
 </ItemGroup>
 <Target Name="Configure" BeforeTargets="RunTailwindCSSTask">
 <PropertyGroup>
 <InputFilename>$(ProjectDir)tailwind.css</InputFilename>
 <OutputFilename>wwwroot\css\app.css</OutputFilename>
 <IsMinify Condition="'$(Configuration)' == 'Release'">true</IsMinify>
 <DebugMode Condition="'$(Configuration)' == 'Debug'">true</DebugMode>
 </PropertyGroup>
 </Target>
</Project>

• Set DebugMode="true" to generate source maps
• Set IsMinify="false" for readable CSS output

• Set IsMinify="true" to reduce file size
• Set DebugMode="false" to disable source maps

Check out the DotnetDevKR.TailwindCSS.WebTest folder for a complete Blazor WebAssembly example that demonstrates:

• Basic TailwindCSS integration
• MSBuild configuration
• File structure organization

1. MSBuild Integration: The package registers a build task that runs before the main build
2. Platform Detection: Automatically detects your OS and architecture
3. TailwindCSS Execution: Runs the appropriate TailwindCSS standalone executable
4. File Processing: Compiles your input CSS file and outputs the result

This package follows a 4-part version scheme that directly maps to TailwindCSS versions:

{TailwindMajor}.{TailwindMinor}.{TailwindPatch}.{Revision}

• First 3 parts: Directly correspond to the TailwindCSS version
• 4th part (Revision): Increments for package-only fixes (without TailwindCSS version change)

This versioning makes it easy to identify which TailwindCSS version is included in the package at a glance.

This package automatically stays up-to-date with the latest TailwindCSS releases:

• 🤖 Automated Checks: Daily automated checks for new TailwindCSS versions
• 📦 Auto-Publishing: Automatically builds and publishes updated NuGet packages
• 🏷️ Version Format: {TailwindMajor}.{TailwindMinor}.{TailwindPatch}.{Revision} (e.g., 4.1.17.0)
• 🔄 Seamless Updates: Simply update the NuGet package to get the latest TailwindCSS features

When a new TailwindCSS version is released, our GitHub Actions workflow:

1. Detects the new version from NuGet registry
2. Creates a new package version (e.g., 4.1.18.0)
3. Downloads the latest TailwindCSS executables
4. Builds and publishes to NuGet.org
5. Creates a GitHub release with release notes

• .NET 6.0 or higher
• Any platform supported by .NET (Windows, macOS, Linux)

Contributions are welcome! Please feel free to submit a Pull Request.

This project is licensed under the Mozilla Public License 2.0 - see the LICENSE.md file for details.

• TailwindCSS for the amazing CSS framework (MIT LICENSE)
• TailwindCSS CLI for the standalone executable
• AspNetCore.SassCompiler – inspiration for CSS compilation and tooling integration

Made with ❤️ by DotnetDevKR and Forum