Clean.Architecture.Solution.Template 11.0.0

dotnet new install Clean.Architecture.Solution.Template@11.0.0
                    
This package contains a .NET Template Package you can call from the shell/command line.

Clean Architecture Solution Template

Build CodeQL Nuget Nuget Twitter Follow

The goal of this template is to provide a straightforward and efficient approach to enterprise application development, leveraging the power of Clean Architecture and ASP.NET Core. Using this template, you can effortlessly create a new app with Angular, React, or Web API only, powered by ASP.NET Core and Aspire. Getting started is easy - simply install the .NET template (see below for full details).

For full documentation, visit cleanarchitecture.jasontaylor.dev.

If you find this project useful, please give it a star. Thanks! ⭐

Getting started

Prerequisites

  • .NET 10.0 SDK or later (.NET 11.0 SDK or later to target .NET 11)
  • Node.js (LTS), only required if you plan to use the Angular or React frontend
  • Docker Desktop or Podman (or any OCI-compliant container runtime), only required when using SQL Server or PostgreSQL. Not required when using SQLite (the default).

Install the template

dotnet new install Clean.Architecture.Solution.Template

Create a new solution

Create a new solution using the template. Specify the target framework using --framework (-f), the client framework using --client-framework (-cf) and the database provider using --database (-db):

dotnet new ca-sln --framework [net10.0|net11.0] --client-framework [angular|react|none] --database [postgresql|sqlite|sqlserver] --output YourProjectName
Option Values Default
--framework net10.0, net11.0 net10.0
--client-framework angular, react, none angular
--database postgresql, sqlite, sqlserver sqlite

Examples:

🅰️ Angular SPA with ASP.NET Core Web API and PostgreSQL:

dotnet new ca-sln -cf angular -db postgresql -o YourProjectName

⚛️ React SPA with ASP.NET Core Web API and SQL Server:

dotnet new ca-sln -cf react -db sqlserver -o YourProjectName

🔌 ASP.NET Core Web API only with SQLite:

dotnet new ca-sln -cf none -db sqlite -o YourProjectName

🆕 Angular SPA on .NET 11 with SQL Server:

dotnet new ca-sln -f net11.0 -cf angular -db sqlserver -o YourProjectName

💡 Tip: Run dotnet new ca-sln --help to see all available template options.

Run the app

Using the Aspire CLI (recommended):

aspire run

Or using the .NET CLI:

dotnet run --project ./src/AppHost

The Aspire dashboard will open automatically, showing the application URLs and logs.

Generated solutions also include a Dev Container with the .NET SDK, the Aspire CLI, Docker and (for Angular or React) Node.js, so you can open them in VS Code with Reopen in Container or in GitHub Codespaces.

To learn more, see the Getting started guide and Architecture overview.

Technologies

Versions

The main branch supports .NET 10.0 (LTS, the default) and .NET 11.0 (STS); choose with --framework. Both are supported until November 2028. .NET 11 with PostgreSQL uses a release candidate of the Npgsql EF Core provider until its 11.0 release. Previous versions are available:

Version Branch
.NET 9.0 net9.0
.NET 8.0 net8.0
.NET 7.0 net7.0
.NET 6.0 net6.0
.NET 5.0 net5.0
.NET Core 3.1 netcore3.1

Architectural decisions

Key design decisions are documented as Architecture Decision Records.

Learn more

Support

If you are having problems, please let me know by raising a new issue.

License

This project is licensed under the MIT License.

This package has no dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
11.0.0 115 11/17/2026
10.9.0 98 11/17/2026
10.8.0 6,370 3/23/2026
10.7.2 519 3/21/2026
10.7.1 476 3/19/2026
10.7.0 454 3/18/2026
10.6.2 542 3/16/2026
10.6.1 582 3/12/2026
10.6.0 471 3/12/2026
10.5.1 474 3/11/2026
10.5.0 485 3/10/2026
10.4.1 635 3/5/2026
10.4.0 418 3/5/2026
10.3.0 596 3/2/2026
10.2.1 475 3/1/2026
10.2.0 443 3/1/2026
10.1.0 461 2/28/2026
10.0.0 4,831 11/11/2025
9.0.12 4,337 7/28/2025
9.0.11 1,373 7/22/2025
Loading failed

## Highlights

* Support .NET 10 and .NET 11 side by side. Choose the framework with the new `--framework` (`-f`) option; .NET 10 remains the default (#1694)
 ```
 dotnet new ca-sln -f net11.0 -cf angular -db postgresql -o MyApp
 ```
* Fix the Dev Container, which now includes the .NET SDK for your chosen framework, the Aspire CLI, Docker, the Azure Developer CLI and Node (when a client is selected) (#1695)
* Fix the Angular and React clients failing to start on a machine with only the .NET 11 SDK. NSwag now runs on the matching runtime (#1695)
* Update AutoMapper to 17.0.0 and MediatR to 15.0.0, which target .NET 10 and .NET 11 (#1697)
* Update the READMEs and docs for .NET 10 and 11 and the Dev Container (#1696)

## Notes

* PostgreSQL on .NET 11 uses Npgsql 11.0.0-rc.3 until Npgsql 11 is released. You may see NU1608 warnings, which are expected.
* The template is now published to NuGet with Trusted Publishing.

Read more in the release post: https://jasontaylor.dev/clean-architecture-template-11-0-0-net-10-and-net-11-side-by-side/

**Full Changelog**: https://github.com/jasontaylordev/CleanArchitecture/compare/v10.9.0...v11.0.0