How to add authentication to the Clean Architecture template?

Integrate ASP.NET Core Identity or external providers like OAuth; the template provides a base structure, but you'll need to implement authentication logic in the Application and Infrastructure layers, following ASP.NET Core security practices.

Clean Architecture template vs ABP Framework for .NET?

This template is leaner and focused on Clean Architecture with frontend flexibility, ideal for custom projects. ABP Framework offers more out-of-the-box features like UI kits and multi-tenancy but adds complexity and may be overkill for simpler needs.

Does the Clean Architecture template support Blazor?

No, it only supports Angular and React for frontends; for Blazor, you'd need to manually integrate it by modifying the project structure or using a different template, as stated in the client-framework options.

How to deploy the Clean Architecture template to Azure?

Use Azure App Services or containerized deployment with Docker; the Aspire integration helps with cloud-native setup, but you must configure Azure resources and update connection strings based on your database choice.

What are the performance trade-offs of using MediatR in this template?

MediatR adds abstraction for CQRS, which can improve maintainability but may introduce slight overhead in request handling; for high-performance scenarios, consider optimizing mediator pipelines or using direct service calls.

How to switch databases after creating a project with this template?

Update the database provider in the Infrastructure layer's DbContext and app settings, then regenerate migrations; the template's flexible database support makes this feasible but requires careful data migration steps.

Open-Awesome

CleanArchitecture (SPA)

MITC#v10.8.0

A Clean Architecture solution template for ASP.NET Core with Angular, React, or Web API options, powered by Aspire.

Visit Website GitHub

20.7k stars4.3k forks0 contributors

What is CleanArchitecture (SPA)?

Clean Architecture Solution Template is a .NET project template that provides a structured foundation for building enterprise applications using Clean Architecture principles with ASP.NET Core. It enables developers to quickly generate solutions with optional Angular or React frontends, multiple database providers, and integrated testing frameworks. The template addresses the complexity of setting up a maintainable, scalable architecture from scratch.

Target Audience

Enterprise developers and teams building ASP.NET Core applications who want to adopt Clean Architecture patterns without extensive initial setup. It's ideal for those creating new projects that require separation of concerns, testability, and modern frontend integration.

Value Proposition

Developers choose this template because it offers a production-ready, opinionated starting point that enforces best practices and reduces boilerplate. Its flexibility in frontend and database choices, combined with Aspire integration for cloud-native development, provides a comprehensive solution that accelerates project kickoff while maintaining architectural integrity.

Overview

Clean Architecture Solution Template for ASP.NET Core

Use Cases

Best For

Starting new enterprise ASP.NET Core applications with Clean Architecture
Projects requiring both Angular and React frontend options
Teams adopting .NET Aspire for cloud-native development
Applications needing flexible database support (SQLite, PostgreSQL, SQL Server)
Enforcing consistent architecture and testing patterns across teams
Rapid prototyping with production-ready infrastructure

Not Ideal For

Projects requiring non-SQL databases like MongoDB or Cosmos DB
Teams using alternative frontend frameworks such as Vue.js or Blazor
Simple applications where the overhead of Clean Architecture is unjustified
Organizations with strict policies against specific third-party dependencies like MediatR or AutoMapper

Pros & Cons

Pros

Flexible Frontend Integration

Supports Angular, React, or API-only setups, allowing teams to choose based on expertise without extra configuration, as highlighted in the multi-framework support feature.

Database Portability

Offers SQLite, PostgreSQL, and SQL Server options, enabling easy switching and local development with defaults like SQLite, per the database flexibility section.

Comprehensive Testing Infrastructure

Includes NUnit, Shouldly, Moq, and Respawn for unit and integration testing, reducing setup time and enforcing testability from the start.

Cloud-Native Development Support

Integrated with .NET Aspire for orchestration and cloud-native patterns, streamlining deployment and monitoring in modern environments.

Cons

Steep Learning Curve

Enforces Clean Architecture principles with layered projects, which can be overwhelming for teams new to this pattern, requiring significant onboarding time.

Dependency Heavy

Relies on multiple third-party libraries (e.g., MediatR, AutoMapper), increasing maintenance risks and potential compatibility issues with updates.

Limited Frontend Framework Choices

Only supports Angular and React, excluding other popular options like Vue.js or Svelte, which may force teams into a specific technology stack.

Frequently Asked Questions

Related Projects

CleanArchitecture

Clean Architecture Solution Template: A proven Clean Architecture Template for ASP.NET Core 10

Stars18,524

Forks3,142

Last commit1 month ago

.NET Boxed Templates

.NET project templates with batteries included, providing the minimum amount of code required to get you going faster.

Stars3,483

Forks496

Last commit9 days ago

JavaScriptServices

[Archived] This repository has been archived

Stars3,001

Forks511

Last commit6 years ago

Serene

Business Apps Made Simple with Asp.Net Core MVC / TypeScript

Stars2,694

Forks804

Last commit1 day ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub