Clean.Architecture.Solution.Template
11.0.0
dotnet new install Clean.Architecture.Solution.Template@11.0.0
Clean Architecture Solution Template
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 --helpto 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
- ASP.NET Core 10 or 11
- Aspire
- Entity Framework Core 10 or 11
- Angular 22 or React 19
- MediatR
- AutoMapper
- FluentValidation
- NUnit, Shouldly, Moq & Respawn
- Scalar
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 | 123 | 11/17/2026 |
| 10.9.0 | 98 | 11/17/2026 |
| 10.8.0 | 6,374 | 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,374 | 7/22/2025 |
## 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