Clean Architecture

A starting point for Clean Architecture with ASP.NET Core. Clean Architecture is just the latest in a series of names for the same loosely-coupled, dependency-inverted architecture. You will also find it named hexagonal, ports-and-adapters, or onion architecture.

Learn more about Clean Architecture and this template in NimblePros' Introducing Clean Architecture course. Use code ARDALIS to save 20%.

This architecture is used in the DDD Fundamentals course by Steve Smith and Julie Lerman.

:school: Contact Steve's company, NimblePros, for Clean Architecture or DDD training and/or implementation assistance for your team.

Take the Course!

Learn about how to implement Clean Architecture from NimblePros trainers Sarah "sadukie" Dutkiewicz and Steve "ardalis" Smith.

Table Of Contents

• Clean Architecture
  • Take the Course!
  • Table Of Contents
  • Give a Star! :star:
  • Sponsors
  • Troubleshooting Chrome Errors
  • Versions
  • Learn More
• Getting Started
  • Template Installation
  • Using the dotnet CLI template
    • Full Clean Architecture (clean-arch)
    • Minimal Clean Architecture (min-clean)
  • Template Comparison
    • Which Template Should I Use?
  • What about Controllers and Razor Pages?
    • Add Ardalis.ApiEndpoints
    • Add Controllers
    • Add Razor Pages
  • Using the GitHub Repository
  • Running Migrations
• Goals
  • History and Shameless Plug Section
• Design Decisions and Dependencies
  • Where To Validate
  • The Core Project
  • The Use Cases Project
  • The Infrastructure Project
  • The Web Project
  • The SharedKernel Package
  • The Test Projects
• Patterns Used
  • Domain Events
  • Related Projects
  • 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 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 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.

Learn More

• Live Stream Recordings Working on Clean Architecture
• DotNetRocks Podcast Discussion with Steve "ardalis" Smith
• Fritz and Friends Streaming Discussion with Steve "ardalis" Smith

Documentation

The official documentation for this template, including Getting Started steps, Migration Guides, and Architectural Decisions, can be found at Ardalis Clean Architecture Docs.

If you are upgrading from an older version, please be sure to review our Migration Guides on the new documentation site!