CleanCli 1.0.2

CleanCli

Scaffold a production-ready .NET 9 Clean Architecture API in seconds.

Install

dotnet tool install -g CleanCli

Usage

cleancli new

Answer a few prompts and your project is ready.

Project name: MyApp
Database: MSSQL / PostgreSQL
Include JWT authentication? Y/N
Include Docker support? Y/N
Output directory: ./MyApp
 
┌─────────────────────────────────┐
│ Setting        │ Value          │
│ Project Name   │ MyApp          │
│ Database       │ MSSQL          │
│ JWT Auth       │ Yes            │
│ Docker         │ Yes            │
│ Output         │ ./MyApp        │
└─────────────────────────────────┘
 
Generate project? Y
 
✓ Project generated successfully!
 
  cd ./MyApp
  dotnet restore
  dotnet run --project src/MyApp.Api

What Gets Generated

MyApp/
├── src/
│   ├── MyApp.Api               # Controllers, Program.cs, middleware
│   ├── MyApp.Application       # MediatR handlers, FluentValidation, DI
│   ├── MyApp.Domain            # Result<T>, Error, ErrorType
│   ├── MyApp.Infrastructure    # Dapper, DbConnectionFactory, DI
│   └── MyApp.Contracts         # Request/response DTOs
├── tests/
├── Dockerfile                  # (if Docker selected)
├── docker-compose.yml          # (if Docker selected)
└── MyApp.sln

Stack

Patterns Included

• Result/Error pattern — Result<T>, Error, ErrorType out of the box, no exceptions for control flow
• MediatR pipeline — ValidationBehavior wired up automatically
• Global exception middleware — unhandled exceptions caught and returned as clean JSON
• CorrelationId middleware — X-Correlation-ID header auto-generated or forwarded on every request
• DI wired per layer — each layer has its own DependencyInjection.cs extension method

Requirements

• .NET 9 SDK

Uninstall

dotnet tool uninstall -g CleanCli

License

MIT