Clean.Architecture.Solution.Template
8.0.0-preview.5.6
See the version list below for details.
dotnet new install Clean.Architecture.Solution.Template::8.0.0-preview.5.6
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 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).
Technologies
- ASP.NET Core 8
- Entity Framework Core 8
- Angular 15 or React 18
- MediatR
- AutoMapper
- FluentValidation
- NUnit, FluentAssertions, Moq & Respawn
Dependencies
The template depends on the latest versions of:
Getting Started
The easiest way to get started is to install the .NET template:
dotnet new install Clean.Architecture.Solution.Template::8.0.0-preview.5.5
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 SPA with Angular:
dotnet new ca-sln --client-framework Angular --output YourProjectName
To create a SPA with React:
dotnet new ca-sln -cf React -o YourProjectName
To create a Web API-only solution:
dotnet new ca-sln -cf None -o YourProjectName
The above commands will create a Single-Page Application (SPA) with Angular or React on top of ASP.NET Core, or a Web API-only solution.
Start the application by navigating to ./src/WebUI
(SPA) or ./src/WebApi
and running:
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 is configured to use an in-memory database by default. This ensures that all users will be able to run the solution without needing to set up additional infrastructure (e.g. SQL Server).
If you would like to use SQL Server, you will need to update WebUI/appsettings.json as follows:
"UseInMemoryDatabase": false,
Verify that the DefaultConnection connection string within appsettings.json points to a valid SQL Server instance.
When you run the application the database will be automatically created (if necessary) and the latest migrations will be applied.
Database Migrations
To use dotnet-ef
for your migrations first ensure that "UseInMemoryDatabase" is disabled, as described within previous section.
Then, add the following flags to your command (values assume you are executing from repository root)
--project src/Infrastructure
(optional if in this folder)--startup-project src/WebUI
--output-dir Persistence/Migrations
For example, to add a new migration from the root folder:
dotnet ef migrations add "SampleMigration" --project src\Infrastructure --startup-project src\WebUI --output-dir Persistence\Migrations
Versions
The main branch is now on .NET 8.0. The following previous versions are available:
Learn More
- Clean Architecture with ASP.NET Core 3.0 (GOTO 2019)
- Clean Architecture with .NET Core: Getting Started
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.0 | 72 | 11/15/2024 |
9.0.0-preview.6.1 | 572 | 9/5/2024 |
9.0.0-preview.6 | 120 | 9/1/2024 |
8.0.6 | 3,835 | 8/31/2024 |
8.0.5 | 9,785 | 3/7/2024 |
8.0.4 | 1,250 | 3/3/2024 |
8.0.3 | 2,504 | 2/15/2024 |
8.0.2 | 7,408 | 11/23/2023 |
8.0.1 | 1,759 | 11/22/2023 |
8.0.0 | 6,625 | 11/15/2023 |
8.0.0-preview.7.2 | 3,752 | 8/29/2023 |
8.0.0-preview.7.1 | 96 | 8/29/2023 |
8.0.0-preview.6.18 | 1,098 | 8/6/2023 |
8.0.0-preview.6.17 | 183 | 8/3/2023 |
8.0.0-preview.6.16 | 156 | 8/2/2023 |
8.0.0-preview.6.15 | 126 | 8/1/2023 |
8.0.0-preview.6.14 | 225 | 7/30/2023 |
8.0.0-preview.6.13 | 94 | 7/30/2023 |
8.0.0-preview.6.12 | 143 | 7/29/2023 |
8.0.0-preview.6.11 | 212 | 7/26/2023 |
8.0.0-preview.6.10 | 240 | 7/23/2023 |
8.0.0-preview.6.9 | 234 | 7/19/2023 |
8.0.0-preview.6.8 | 100 | 7/19/2023 |
8.0.0-preview.6.7 | 125 | 7/19/2023 |
8.0.0-preview.6.6 | 139 | 7/18/2023 |
8.0.0-preview.6.5 | 192 | 7/16/2023 |
8.0.0-preview.6.4 | 127 | 7/16/2023 |
8.0.0-preview.6.3 | 150 | 7/14/2023 |
8.0.0-preview.6.2 | 116 | 7/14/2023 |
8.0.0-preview.6.1 | 160 | 7/13/2023 |
8.0.0-preview.6 | 122 | 7/12/2023 |
8.0.0-preview.5.15 | 105 | 7/12/2023 |
8.0.0-preview.5.14 | 223 | 7/9/2023 |
8.0.0-preview.5.13 | 118 | 7/9/2023 |
8.0.0-preview.5.12 | 121 | 7/8/2023 |
8.0.0-preview.5.11 | 94 | 7/8/2023 |
8.0.0-preview.5.10 | 97 | 7/8/2023 |
8.0.0-preview.5.9 | 96 | 7/8/2023 |
8.0.0-preview.5.8 | 96 | 7/8/2023 |
8.0.0-preview.5.7 | 108 | 7/8/2023 |
8.0.0-preview.5.6 | 105 | 7/7/2023 |
8.0.0-preview.5.5 | 213 | 7/5/2023 |
8.0.0-preview.5.4 | 133 | 7/5/2023 |
8.0.0-preview.5.3 | 162 | 7/4/2023 |
8.0.0-preview.5.2 | 266 | 6/29/2023 |
8.0.0-preview.5.1 | 156 | 6/26/2023 |
8.0.0-preview.5 | 188 | 6/18/2023 |
7.0.2 | 8,978 | 6/14/2023 |
7.0.1 | 7,337 | 2/21/2023 |
7.0.0 | 7,381 | 10/19/2022 |
6.1.0 | 9,022 | 6/6/2022 |
6.0.8 | 2,909 | 6/1/2022 |
6.0.7 | 3,098 | 5/25/2022 |
6.0.6 | 6,115 | 5/24/2022 |
6.0.5 | 2,549 | 5/21/2022 |
6.0.2 | 2,802 | 5/20/2022 |
6.0.1 | 9,495 | 11/13/2021 |
6.0.0 | 2,843 | 11/10/2021 |
1.1.5 | 7,806 | 7/10/2021 |
1.1.4 | 10,458 | 12/2/2020 |
1.1.2 | 2,833 | 11/24/2020 |
1.1.1 | 8,674 | 5/20/2020 |
1.1.0 | 4,754 | 4/11/2020 |
1.0.10 | 3,316 | 3/30/2020 |
1.0.9 | 2,957 | 3/26/2020 |
1.0.8 | 3,197 | 3/24/2020 |
1.0.7 | 3,221 | 3/23/2020 |
1.0.6 | 4,126 | 2/6/2020 |
1.0.5 | 4,382 | 12/9/2019 |
1.0.4 | 4,240 | 11/13/2019 |
1.0.3 | 3,159 | 10/17/2019 |
1.0.2 | 3,321 | 10/16/2019 |
1.0.1 | 3,100 | 10/10/2019 |
Fixed bug in Web API template (missing NuGet package).