ardalis / CleanArchitecture

PublicGitHub 原仓库 ↗
…
README
Raw ↗

Clean Architecture

Build & Test (Clean Architecture) Build & Test (MinimalClean) CodeQL Docs

Ardalis.CleanArchitecture.Template on NuGet Ardalis.CleanArchitecture.Template downloads Ardalis.MinimalClean.Template on NuGet Ardalis.MinimalClean.Template downloads

.NET 11 License: MIT GitHub stars Follow @ardalis Follow @nimblepros

dotnet new templates for building ASP.NET Core applications with Clean Architecture, also known as hexagonal, ports-and-adapters, or onion architecture. The domain model sits at the center, and dependencies point inward toward it.

There are two templates:

  • Full Clean Architecture (clean-arch): a multi-project solution (Core, UseCases, Infrastructure, Web) with DDD patterns, CQRS via Mediator, and FastEndpoints. Best for larger, long-lived applications.
  • Minimal Clean Architecture (min-clean): a single project organized by vertical slices, with layer boundaries enforced by NsDepCop. Best for MVPs and smaller applications.

A complete sample application lives in /sample.

Getting Started

Install the templates from NuGet:

dotnet new install Ardalis.CleanArchitecture.Template
dotnet new install Ardalis.MinimalClean.Template

Create a solution from either template:

# Full Clean Architecture
dotnet new clean-arch -o Your.ProjectName

# Minimal Clean Architecture
dotnet new min-clean -o Your.ProjectName

Documentation

Everything else is in the docs: cleanarchitecture.ardalis.com. That includes getting started, choosing between the templates, design decisions, dependency rules, and migration guides for upgrading from earlier versions.

Learn More

If this project helps you, please give it a star :star:. You can also support it through GitHub Sponsors.

浏览 ardalis/CleanArchitecture