pkg
jd-toon/Swap.Templatesv1.3.0
.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
Quick Start (Recommended)
The Modular Monolith template is the best way to start a new Swap.Htmx project. It provides a well-structured foundation that scales from prototypes to production applications.
dotnet new swap-modular -n MyApp
cd MyApp/src
libman restore
dotnet run
Open https://localhost:5001 and you have a working application with:
- Clean sidebar navigation with SPA-style HTMX routing
- Sample Notes module demonstrating full CRUD operations
- Modular architecture ready for adding your own features
- Docker support for easy deployment
Available Templates
| Template Name | Short Name | Description |
|---|---|---|
| Swap.Htmx Modular Monolith | swap-modular | Recommended. Full-featured modular monolith with SQLite, EF Core, Docker, and a sample Notes module. |
| Swap.Htmx MVC App | swap-mvc | A clean, minimal MVC project with Swap.Htmx pre-configured. |
Usage
Create a Modular Monolith Project (Recommended)
dotnet new swap-modular -n MyApp
cd MyApp/src
libman restore
dotnet run
Create a Minimal MVC Project
dotnet new swap-mvc -n MyProject
cd MyProject
libman restore
dotnet run
Notes:
libman restoreis required to download client libraries (htmx and, if enabled, the htmx SSE extension).- If you enable
--IncludeSse, the template also wires up the server-side SSE event bridge.