CleanArch.Tool 2.0.3

cleanarch — .NET Global Tool

Create production-ready ASP.NET 8 Clean Architecture projects interactively — like Vercel for .NET.

Install

dotnet tool install -g CleanArch.Tool

Usage

cleanarch new

Interactively asks:

• Project name
• Database (SQL Server / PostgreSQL / SQLite)
• Features (Redis, YARP Gateway, Docker, Health Checks, API Versioning...)
• Auth type (JWT / OAuth / Both)
• Push to GitHub (optional)

What gets generated

MyApp/
├── src/
│   ├── MyApp.Domain/          # Entities, Value Objects, Domain Events
│   ├── MyApp.Application/     # CQRS Commands & Queries (MediatR)
│   ├── MyApp.Infrastructure/  # EF Core, Redis, JWT, BCrypt
│   ├── MyApp.API/             # ASP.NET 8 Web API + Swagger
│   └── MyApp.Gateway/         # YARP Reverse Proxy (optional)
├── tests/
│   └── MyApp.UnitTests/
├── docker-compose.yml
└── MyApp.sln

Scaffold new entities

cleanarch scaffold Product Order Category

Generates full CQRS boilerplate: Entity, Commands, Queries, Controller, EF Config. Run from anywhere inside a generated project — the tool walks up to find the .sln.

Run

cd MyApp
docker-compose up -d --build
# or
dotnet run --project src/API

Architecture

• CQRS via MediatR with Logging → Validation → Caching pipeline
• DDD — Aggregate Roots, Value Objects, Domain Events
• JWT Auth with refresh tokens stored in HttpOnly cookies
• Redis distributed caching with automatic cache-aside pattern
• YARP reverse proxy with round-robin load balancing and rate limiting
• Result pattern — no exceptions for business failures