ardalis/CleanArchitecture v12.0.0

on GitHub

Both templates now share one version number and ship together.

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

Upgrading an existing project? See the v11 → v12 migration guide.

Highlights

• .NET 11. All solutions target net11.0, and every package is on its latest stable version, including FastEndpoints 9 and xUnit v3.
• Get use case renamed to GetById (GetContributorByIdQuery and GetContributorByIdHandler), matching the GetById endpoint (#1202).
• NsDepCop rules in MinimalClean enforce the boundaries between feature slices at build time (#1203, #1204).

Fixes

• ContributorId validation no longer rejects EF Core temporary keys, which made inserts fail (#1195).
• The UseDbGeneratedIds migration no longer fails on SQL Server (#1194).
• Project names that aren't valid namespaces, such as names with hyphens, now produce correctly renamed files (#484).
• Functional tests fall back to SQLite when Docker is unavailable or can't run Linux containers (#1073, #1189).

Cleaner generated solutions

• clean-arch solutions now include a .gitignore.
• clean-arch solutions no longer contain a stray copy of MinimalClean, and installing the package no longer registers min-clean.
• Files that only belong in this repository are no longer copied into new solutions: CODE_OF_CONDUCT.md, CONTRIBUTING.md, icon.png, .claude/, and two outdated testing notes.

Docs

The docs moved to cleanarchitecture.ardalis.com (#1205). They have new pages on Testing, Enforcing Dependency Rules, and Unit of Work and Transactions.

Full changelog: v11.1.1...v12.0.0