MinimalCleanArch 0.1.17-preview

.NET 9.0 This package targets .NET 9.0. The package is compatible with this framework or higher.
This is a prerelease version of MinimalCleanArch.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package MinimalCleanArch --version 0.1.17-preview
                    


                    

                
NuGet\Install-Package MinimalCleanArch -Version 0.1.17-preview
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="MinimalCleanArch" Version="0.1.17-preview" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="MinimalCleanArch" Version="0.1.17-preview" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="MinimalCleanArch" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add MinimalCleanArch --version 0.1.17-preview
                    


                    

                
#r "nuget: MinimalCleanArch, 0.1.17-preview"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package MinimalCleanArch@0.1.17-preview
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=MinimalCleanArch&version=0.1.17-preview&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=MinimalCleanArch&version=0.1.17-preview&prerelease
                    


                            Install as a Cake Tool

MinimalCleanArch

A Clean Architecture toolkit for Minimal APIs on .NET 9 and .NET 10.

Core Features

  • Domain building blocks (entities, repositories, unit of work, specifications, result pattern)
  • Minimal API helpers (validation wiring, standardized error handling, OpenAPI + Scalar)
  • Security and encryption (Data Protection/AES column encryption)
  • Soft delete and auditing support
  • EF Core integration with specification evaluation
  • Core domain and repository abstractions: MinimalCleanArch
  • EF Core repositories and specifications: MinimalCleanArch.DataAccess
  • Minimal API bootstrap, error mapping, OpenAPI, rate limiting: MinimalCleanArch.Extensions
  • FluentValidation registration: MinimalCleanArch.Validation
  • Domain events and Wolverine integration: MinimalCleanArch.Messaging
  • Audit interception and audit queries: MinimalCleanArch.Audit
  • Encrypted EF properties and encryption services: MinimalCleanArch.Security
  • Project scaffolding: MinimalCleanArch.Templates

Versions

  • Stable packages/templates: 0.1.14
  • Next preview line: 0.1.16-preview

Local Validation

  • Template validation uses two package sources by default: the local MinimalCleanArch feed and nuget.org.
  • This is required because generated projects reference both MinimalCleanArch.* packages and pinned third-party packages.
  • Use local-feed-only validation only if your feed mirrors every external dependency used by the templates.

Try It Fast

dotnet new install MinimalCleanArch.Templates
dotnet new mca -n QuickStart --single-project --recommended
cd QuickStart
dotnet run

Then open https://localhost:<port>/scalar/v1.

For auth + OpenIddict + Scalar password flow:

dotnet new mca -n QuickAuth --single-project --auth --tests --mcaVersion 0.1.16-preview
cd QuickAuth
dotnet run

Use the auth walkthrough in templates/README.md.

Preferred Integration Path

For new applications, the recommended order is:

  1. Model entities, repository contracts, and specifications with MinimalCleanArch.
  2. Add EF Core repositories and unit of work with MinimalCleanArch.DataAccess.
  3. Add API bootstrap with MinimalCleanArch.Extensions.
  4. Register application validators with MinimalCleanArch.Validation.
  5. Add MinimalCleanArch.Messaging, MinimalCleanArch.Audit, and MinimalCleanArch.Security only when the app actually needs them.

Preferred defaults:

  • use specifications through IRepository<TEntity, TKey>
  • use AddMinimalCleanArchApi(...) as the main API bootstrap method
  • use AddValidationFromAssemblyContaining<T>() for validator registration
  • use AddMinimalCleanArchMessaging... extensions instead of wiring Wolverine from scratch
  • use Data Protection-based encryption for new development
  • use IExecutionContext as the shared source for user, tenant, and correlation data across HTTP and message-handler flows

Packages

Package Description
MinimalCleanArch Core abstractions and domain primitives.
MinimalCleanArch.DataAccess EF Core repository/unit of work implementation.
MinimalCleanArch.Extensions Minimal API extensions (validation, errors, responses).
MinimalCleanArch.Validation FluentValidation integration components.
MinimalCleanArch.Security Encryption and security utilities.
MinimalCleanArch.Messaging Messaging/domain event helpers.
MinimalCleanArch.Audit Audit logging components.
MinimalCleanArch.Templates dotnet new mca templates.

Documentation Map

Contributing

Contributions are welcome. See CONTRIBUTING.md.

License

MIT. See LICENSE.

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • net10.0

    • No dependencies.

  • net9.0

    • No dependencies.

NuGet packages (5)

Showing the top 5 NuGet packages that depend on MinimalCleanArch:

Package Downloads
MinimalCleanArch.Extensions

Extensions for Minimal API endpoints, including validation filters, error handling, logging, health checks, and standard response definitions.
MinimalCleanArch.Validation

Validation components for MinimalCleanArch using FluentValidation, including extensions for service registration.
MinimalCleanArch.DataAccess

Entity Framework Core implementation for MinimalCleanArch
MinimalCleanArch.Messaging

Messaging and event-driven architecture for MinimalCleanArch using Wolverine. Includes domain events, transactional outbox, and background job processing.
MinimalCleanArch.Audit

Optional audit logging package for MinimalCleanArch. Provides audit log tables, change history tracking, and audit query services. Opt-in feature - only adds overhead when explicitly enabled.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.17 0 3/12/2026
0.1.17-preview 109 3/8/2026
0.1.16-preview 113 3/7/2026
0.1.15-preview 136 3/3/2026
0.1.14 153 3/2/2026
0.1.14-preview 143 3/1/2026
0.1.13-preview 142 2/28/2026
0.1.12-preview 157 2/22/2026
0.1.11-preview 159 12/27/2025
0.1.10-preview 153 12/27/2025
0.1.9-preview 185 12/21/2025
0.1.8-preview 288 12/15/2025
0.1.7 223 12/14/2025
0.1.7-preview 472 12/11/2025
0.1.6 493 12/9/2025
0.1.6-preview 586 12/9/2025
0.1.5 256 12/6/2025
0.1.4 226 5/26/2025
0.1.3 219 5/25/2025
0.1.2 210 5/25/2025
Loading failed