discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens
ardalis/CleanArchitecture · source
Snapshot 0 · 2026-11-04T12:47:24Z · C# · MIT
Content fingerprint
a01abd200731d62af71e4c6dc2fc2349b99110f9cef1cd43953a4f596e20f0d8GitHub description at capture
Clean Architecture Solution Template: A proven Clean Architecture Template for ASP.NET Core 10
README at capture
[](https://github.com/ardalis/CleanArchitecture/actions)
[](https://github.com/ardalis/CleanArchitecture/actions/workflows/publish.yml)
[](https://www.nuget.org/packages/Ardalis.CleanArchitecture.Template/)
<a href="https://twitter.com/intent/follow?screen_name=ardalis">
<img src="https://img.shields.io/twitter/follow/ardalis.svg?label=Follow%20@ardalis" alt="Follow @ardalis" />
</a> <a href="https://twitter.com/intent/follow?screen_name=nimblepros">
<img src="https://img.shields.io/twitter/follow/nimblepros.svg?label=Follow%20@nimblepros" alt="Follow @nimblepros" />
</a>
<p>
</p>
# Clean Architecture
A starting point for Clean Architecture with ASP.NET Core. [Clean Architecture](https://8thlight.com/blog/uncle-bob/2012/08/13/the-clean-architecture.html) is just the latest in a series of names for the same loosely-coupled, dependency-inverted architecture. You will also find it named [hexagonal](https://alistair.cockburn.us/hexagonal-architecture), [ports-and-adapters](http://www.dossier-andreas.net/software_architecture/ports_and_adapters.html), or [onion architecture](http://jeffreypalermo.com/blog/the-onion-architecture-part-1/).
Learn more about Clean Architecture and this template in [NimblePros' Introducing Clean Architecture course](https://academy.nimblepros.com/p/learn-clean-architecture). Use code ARDALIS to save 20%.
This architecture is used in the [DDD Fundamentals course](https://www.pluralsight.com/courses/fundamentals-domain-driven-design) by [Steve Smith](https://ardalis.com) and [Julie Lerman](https://thedatafarm.com/).
:school: Contact Steve's company, [NimblePros](https://nimblepros.com/), for Clean Architecture or DDD training and/or implementation assistance for your team.
## Take the Course!
[Learn about how to implement Clean Architecture](https://academy.nimblepros.com/p/intro-to-clean-architecture) from [NimblePros](https://nimblepros.com) trainers [Sarah "sadukie" Dutkiewicz](https://blog.nimblepros.com/author/sadukie/) and [Steve "ardalis" Smith](https://blog.nimblepros.com/author/ardalis/).
## Table Of Contents
- [Clean Architecture](#clean-architecture)
- [Take the Course!](#take-the-course)
- [Table Of Contents](#table-of-contents)
- [Give a Star! :star:](#give-a-star-star)
- [Sponsors](#sponsors)
- [Troubleshooting Chrome Errors](#troubleshooting-chrome-errors)
- [Versions](#versions)
- [Learn More](#learn-more)
- [Getting Started](#getting-started)
- [Template Installation](#template-installation)
- [Using the dotnet CLI template](#using-the-dotnet-cli-template)
- [Full Clean Architecture (`clean-arch`)](#full-clean-architecture-clean-arch)
- [Minimal Clean Architecture (`min-clean`)](#minimal-clean-architecture-min-clean)
- [Template Comparison](#template-comparison)
- [Which Template Should I Use?](#which-template-should-i-use)
- [What about Controllers and Razor Pages?](#what-about-controllers-and-razor-pages)
- [Add Ardalis.ApiEndpoints](#add-ardalisapiendpoints)
- [Add Controllers](#add-controllers)
- [Add Razor Pages](#add-razor-pages)
- [Using the GitHub Repository](#using-the-github-repository)
- [Running Migrations](#running-migrations)
- [Goals](#goals)
- [History and Shameless Plug Section](#history-and-shameless-plug-section)
- [Design Decisions and Dependencies](#design-decisions-and-dependencies)
- [Where To Validate](#where-to-validate)
- [The Core Project](#the-core-project)
- [The Use Cases Project](#the-use-cases-project)
- [The Infrastructure Project](#the-infrastructure-project)
- [The Web Project](#the-web-project)
- [The SharedKernel Package](#the-sharedkernel-package)
- [The Test Projects](#the-test-projects)
- [Patterns Used](#patterns-used)
- [Domain Events](#domain-events)
- [Related Projects](#related-projects)
- [Presentations and Videos on Clean Architecture](#presentations-and-videos-on-clean-architecture)
## Give a Star! :star:
If you like or are using this project to learn or start your solution, please give it a star. Thanks!
Or if you're feeling really generous, we now support GitHub sponsorships - see the button above.
## Sponsors
I'm please to announce that [Amazon AWS's FOSS fund](https://github.com/aws/dotnet-foss) has chosen to award a 12-month sponsorship to this project. Thank you, and thanks to all of my other past and current sponsors!
## Troubleshooting Chrome Errors
By default the site uses HTTPS and expects you to have a self-signed developer certificate for localhost use. If you get an error with Chrome [see this answer](https://stackoverflow.com/a/31900210/13729) for mitigation instructions.
## Versions
The main branch is now using **.NET 9**. This corresponds with NuGet package version 10.x. Previous versions are available - see our [Releases](https://github.com/ardalis/CleanArchitecture/releases).
## Learn More
- [Live Stream Recordings Working on Clean Architecture](https://www.youtube.com/c/Ardalis/search?query=clean%20architecture)
- [DotNetRocks Podcast Discussion with Steve "ardalis" Smith](https://player.fm/series/net-rocks/clean-architecture-with-steve-smith)
- [Fritz and Friends Streaming Discussion with Steve "ardalis" Smith](https://www.youtube.com/watch?v=k8cZUW4MS3I)
# Documentation
The official documentation for this template, including Getting Started steps, Migration Guides, and Architectural Decisions, can be found at [Ardalis Clean Architecture Docs](https://ardalis.github.io/CleanArchitecture).
If you are upgrading from an older version, please be sure to review our [Migration Guides](https://ardalis.github.io/CleanArchitecture/migration-guides/) on the new documentation site!