Clean.Architecture.Solution.Template 9.0.12

dotnet new install Clean.Architecture.Solution.Template::9.0.12
                    
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 Single Page App (SPA) with ASP.NET Core and Angular or React, while adhering to the principles of Clean Architecture. Getting started is easy - simply install the .NET template (see below for full details).

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

Getting Started

The following prerequisites are required to build and run the solution:

  • .NET 9.0 SDK (latest version)
  • Node.js (latest LTS, only required if you are using Angular or React)

The easiest way to get started is to install the .NET template:

dotnet new install Clean.Architecture.Solution.Template

Once installed, create a new solution using the template. You can choose to use Angular, React, or create a Web API-only solution. Specify the client framework using the -cf or --client-framework option, and provide the output directory where your project will be created. Here are some examples:

To create a Single-Page Application (SPA) with Angular and ASP.NET Core:

dotnet new ca-sln --client-framework Angular --output YourProjectName

To create a SPA with React and ASP.NET Core:

dotnet new ca-sln -cf React -o YourProjectName

To create a ASP.NET Core Web API-only solution:

dotnet new ca-sln -cf None -o YourProjectName

Launch the app:

cd src/Web
dotnet run

To learn more, run the following command:

dotnet new ca-sln --help

You can create use cases (commands or queries) by navigating to ./src/Application and running dotnet new ca-usecase. Here are some examples:

To create a new command:

dotnet new ca-usecase --name CreateTodoList --feature-name TodoLists --usecase-type command --return-type int

To create a query:

dotnet new ca-usecase -n GetTodos -fn TodoLists -ut query -rt TodosVm

To learn more, run the following command:

dotnet new ca-usecase --help

Database

The template supports PostgreSQL, SQLite, and SQL Server (default option). Specify the database to use with the --database option:

dotnet new ca-sln --database [postgresql|sqlite|sqlserver]

On application startup, the database is automatically deleted, recreated, and seeded using ApplicationDbContextInitialiser. This is a practical strategy for early development, avoiding the overhead of maintaining migrations while keeping the schema and sample data in sync with the domain model.

This process includes:

  • Deleting the existing database
  • Recreating the schema from the current model
  • Seeding default roles, users, and data

For production environments, consider using EF Core migrations or migration bundles during deployment.
For more information, see Database Initialisation Strategies for EF Core.

Deploy

This template is structured to follow the Azure Developer CLI (azd). You can learn more about azd in the official documentation. To get started:

# Log in to Azure
azd auth login

# Provision and deploy to Azure
azd up

Technologies

Versions

The main branch is now on .NET 9.0. The following previous versions are available:

Learn More

Support

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

License

This project is licensed with 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
9.0.12 236 7/28/2025
9.0.11 642 7/22/2025
9.0.10 2,384 5/23/2025
9.0.9 254 5/21/2025
9.0.8 7,075 12/6/2024
9.0.7 124 12/6/2024
9.0.6 312 12/2/2024
9.0.5 224 11/30/2024
9.0.4 206 11/29/2024
9.0.3 133 11/29/2024
9.0.2 132 11/28/2024
9.0.1 768 11/18/2024
9.0.0 398 11/15/2024
9.0.0-preview.6.1 657 9/5/2024
9.0.0-preview.6 181 9/1/2024
8.0.6 5,185 8/31/2024
8.0.5 9,886 3/7/2024
8.0.4 1,318 3/3/2024
8.0.3 2,546 2/15/2024
8.0.2 7,468 11/23/2023
8.0.1 1,822 11/22/2023
8.0.0 6,887 11/15/2023
8.0.0-preview.7.2 3,796 8/29/2023
8.0.0-preview.7.1 132 8/29/2023
8.0.0-preview.6.18 1,141 8/6/2023
8.0.0-preview.6.17 221 8/3/2023
8.0.0-preview.6.16 194 8/2/2023
8.0.0-preview.6.15 166 8/1/2023
8.0.0-preview.6.14 269 7/30/2023
8.0.0-preview.6.13 133 7/30/2023
8.0.0-preview.6.12 191 7/29/2023
8.0.0-preview.6.11 254 7/26/2023
8.0.0-preview.6.10 280 7/23/2023
8.0.0-preview.6.9 289 7/19/2023
8.0.0-preview.6.8 146 7/19/2023
8.0.0-preview.6.7 164 7/19/2023
8.0.0-preview.6.6 174 7/18/2023
8.0.0-preview.6.5 239 7/16/2023
8.0.0-preview.6.4 168 7/16/2023
8.0.0-preview.6.3 186 7/14/2023
8.0.0-preview.6.2 152 7/14/2023
8.0.0-preview.6.1 197 7/13/2023
8.0.0-preview.6 166 7/12/2023
8.0.0-preview.5.15 149 7/12/2023
8.0.0-preview.5.14 269 7/9/2023
8.0.0-preview.5.13 165 7/9/2023
8.0.0-preview.5.12 162 7/8/2023
8.0.0-preview.5.11 128 7/8/2023
8.0.0-preview.5.10 139 7/8/2023
8.0.0-preview.5.9 136 7/8/2023
8.0.0-preview.5.8 138 7/8/2023
8.0.0-preview.5.7 160 7/8/2023
8.0.0-preview.5.6 143 7/7/2023
8.0.0-preview.5.5 260 7/5/2023
8.0.0-preview.5.4 181 7/5/2023
8.0.0-preview.5.3 217 7/4/2023
8.0.0-preview.5.2 305 6/29/2023
8.0.0-preview.5.1 196 6/26/2023
8.0.0-preview.5 245 6/18/2023
7.0.2 9,095 6/14/2023
7.0.1 7,392 2/21/2023
7.0.0 7,452 10/19/2022
6.1.0 9,132 6/6/2022
6.0.8 2,986 6/1/2022
6.0.7 3,166 5/25/2022
6.0.6 6,203 5/24/2022
6.0.5 2,622 5/21/2022
6.0.2 2,870 5/20/2022
6.0.1 9,570 11/13/2021
6.0.0 2,926 11/10/2021
1.1.5 7,888 7/10/2021
1.1.4 10,543 12/2/2020
1.1.2 2,928 11/24/2020
1.1.1 8,768 5/20/2020
1.1.0 4,848 4/11/2020
1.0.10 3,409 3/30/2020
1.0.9 3,054 3/26/2020
1.0.8 3,295 3/24/2020
1.0.7 3,320 3/23/2020
1.0.6 4,233 2/6/2020
1.0.5 4,484 12/9/2019
1.0.4 4,344 11/13/2019
1.0.3 3,256 10/17/2019
1.0.2 3,418 10/16/2019
1.0.1 3,198 10/10/2019

🐛 Fixed bug with registration of LoggingBehaviour.
     🐛 Fixed bug with reuse of ValidationContext in ValidationBehaviour.
     ✨ Refactored endpoint mapping to use RouteGroupBuilder.
     ✨ Implementation of TSX support in React template.
     🐛 Fix KeyVault / secret name mismatch in Bicep templates.
     📦 Replace FluentAssertions with Shouldly in tests.
     🐛 Fix using dotnet-ef with artifacts path.
     ✨ Improved performance of authorisation.
     ✨ Enable simplified output paths.