20.6K ·GitHub
What is this?
An open-source .NET solution template that scaffolds a complete ASP.NET Core application structured around Clean Architecture, so teams start from a working, well-layered codebase instead of an empty project.
An open-source .NET solution template that scaffolds a complete ASP.NET Core application structured around Clean Architecture, so teams start from a working, well-layered codebase instead of an empty project.Is this a library I add to my project, or a code generator?It is a .NET project template, not a library: you install it once, then 'dotnet new ca-sln' generates a full solution whose code you then own and extend.
It is a .NET project template, not a library: you install it once, then 'dotnet new ca-sln' generates a full solution whose code you then own and extend.How do I generate a project from it?Install the .NET template, then run 'dotnet new ca-sln' with --client-framework (angular, react, or none) and --database (postgresql, sqlite, or sqlserver); defaults are angular and sqlite. 'dotnet new ca-sln --help' lists all options.
Install the .NET template, then run 'dotnet new ca-sln' with --client-framework (angular, react, or none) and --database (postgresql, sqlite, or sqlserver); defaults are angular and sqlite. 'dotnet new ca-sln --help' lists all options.What do I need installed on my machine first?The .NET 10.0 SDK or later. Node.js (LTS) is only needed for the Angular or React frontend, and Docker Desktop or Podman only for SQL Server or PostgreSQL — the default SQLite needs neither.
The .NET 10.0 SDK or later. Node.js (LTS) is only needed for the Angular or React frontend, and Docker Desktop or Podman only for SQL Server or PostgreSQL — the default SQLite needs neither.What if my team isn't on .NET 10 yet?The main branch targets .NET 10.0, but separate branches maintain older versions — from .NET 9 down to .NET Core 3.1 (net9.0 through netcore3.1).
The main branch targets .NET 10.0, but separate branches maintain older versions — from .NET 9 down to .NET Core 3.1 (net9.0 through netcore3.1).What kind of app do I end up with?A web application: an Angular or React single-page app backed by an ASP.NET Core Web API, or just the Web API if you choose no frontend.
A web application: an Angular or React single-page app backed by an ASP.NET Core Web API, or just the Web API if you choose no frontend.What is Aspire, and why does my app use it?Aspire is part of the .NET stack this template builds on ('powered by ASP.NET Core and Aspire'). In practice you will see its dashboard open when you run the app, showing the application URLs and logs; the linked template documentation covers it in more depth.
Aspire is part of the .NET stack this template builds on ('powered by ASP.NET Core and Aspire'). In practice you will see its dashboard open when you run the app, showing the application URLs and logs; the linked template documentation covers it in more depth.What comes baked into the generated solution?ASP.NET Core 10 with Aspire and Entity Framework Core 10, Angular 21 or React 19 on the frontend, plus MediatR, AutoMapper, FluentValidation, a test stack with NUnit, Shouldly, Moq and Respawn, and Scalar for API documentation.
ASP.NET Core 10 with Aspire and Entity Framework Core 10, Angular 21 or React 19 on the frontend, plus MediatR, AutoMapper, FluentValidation, a test stack with NUnit, Shouldly, Moq and Respawn, and Scalar for API documentation.Where does the template explain its design decisions?In Architecture Decision Records — the repo documents its key design choices as ADRs, so you can read the reasoning behind the structure before committing your project to it.
In Architecture Decision Records — the repo documents its key design choices as ADRs, so you can read the reasoning behind the structure before committing your project to it.What are similar projects?CleanArchitecture, aspnetboilerplate, efcore, modular-monolith-with-ddd, eShopOnWeb, nopCommerce, go-clean-arch, angular-seed
CleanArchitecture, aspnetboilerplate, efcore, modular-monolith-with-ddd, eShopOnWeb, nopCommerce, go-clean-arch, angular-seedWhich topics is it in?entity-framework, scaffolding, clean-architecture, sql-server, software-architecture, unit-testing, angular, template, architecture, dotnet, c#, sqlite
entity-framework, scaffolding, clean-architecture, sql-server, software-architecture, unit-testing, angular, template, architecture, dotnet, c#, sqlite