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! ⭐
The solution template requires the latest version of .NET 8 SDK and Node.js LTS (optional). Node.js is only required for Angular and React solutions.
First, install the .NET template:
dotnet new install Clean.Architecture.Solution.Template::8.0.0-preview.5.14Once 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 YourProjectNameTo create a SPA with React and ASP.NET Core:
dotnet new ca-sln -cf React -o YourProjectNameTo create a ASP.NET Core Web API-only solution:
dotnet new ca-sln -cf None -o YourProjectNameLaunch the app by navigating to ./src/WebUI (SPA) or ./src/WebApi and running:
dotnet runTo learn more, run the following command:
dotnet new ca-sln --helpYou 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 intTo create a query:
dotnet new ca-usecase -n GetTodos -fn TodoLists -ut query -rt TodosVmTo learn more, run the following command:
dotnet new ca-usecase --helpThe template is configured to use SQL Server by default. If you would prefer to use SQLite, create your solution using the following command:
dotnet new ca-sln --use-sqliteWhen you run the application the database will be automatically created (if necessary) and the latest migrations will be applied.
Running database migrations is easy. Ensure you 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/WebUIor--startup-project src/WebApi(Web API only)--output-dir Data/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 Data\Migrations
- ASP.NET Core 8
- Entity Framework Core 8
- Angular 15 or React 18
- MediatR
- AutoMapper
- FluentValidation
- NUnit, FluentAssertions, Moq & Respawn
The main branch is now on .NET 8.0. The following previous versions are available:
- Clean Architecture with ASP.NET Core 3.0 (GOTO 2019)
- Clean Architecture with .NET Core: Getting Started
If you are having problems, please let me know by raising a new issue.
This project is licensed with the MIT license.