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
• 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 client framework using --client-framework (-cf) and the database provider using --database (-db):

dotnet new ca-sln --client-framework [angular|react|none] --database [postgresql|sqlite|sqlserver] --output YourProjectName

Option	Values	Default
--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

💡 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.

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

Technologies

• ASP.NET Core 10
• Aspire
• Entity Framework Core 10
• Angular 21 or React 19
• MediatR
• AutoMapper
• FluentValidation
• NUnit, Shouldly, Moq & Respawn
• Scalar

Versions

The main branch is on .NET 10.0. 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

• 📖 Clean Architecture Solution Template documentation

Support

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

License

This project is licensed under the MIT License.