pkg
jd-toon/Swap.Templatesv0.0.2
.NET Std2.0
Project templates for Swap.Htmx - The Reactive UI Orchestration library for ASP.NET Core. Includes MVC starter and modular monolith templates with pre-configured HTMX, DaisyUI 5, Tailwind CSS v4, LibMan, EF Core, and Source Generators.
Get Started
$ dotnet add package Swap.TemplatesReadme
Swap.Htmx Templates
This package contains project templates for building Swap.Htmx applications.
Installation
Install the templates from NuGet:
dotnet new install Swap.Templates
Available Templates
| Template Name | Short Name | Description |
|---|---|---|
| Swap.Htmx MVC App | swap-mvc | A clean, "batteries-included" MVC project with Swap.Htmx pre-configured. |
Usage
Create a new MVC Project
dotnet new swap-mvc -n MyProject
Options
| Option | Description | Default |
|---|---|---|
--IncludeSse | Include HTMX SSE extension and configuration for real-time updates. | false |
--UseLocalRef | Use local project references (for development of Swap itself). | false |
Example with SSE
dotnet new swap-mvc -n RealtimeApp --IncludeSse
What's Included?
The swap-mvc template provides a production-ready starting point:
- Clean Architecture: No heavy CSS frameworks (Bootstrap/Tailwind) by default—just clean, custom CSS variables.
- LibMan Support: Client-side libraries (HTMX) are managed via
libman.json. - Source Generators:
[SwapEventSource]is pre-configured for type-safe events. - Best Practices:
- Uses
this.SwapView()andthis.SwapResponse()extension methods. - Includes a partial for demonstrating partial updates.
- Uses