CleanArch.Pro 1.0.1

# 🚀 CleanArch.Pro – Production-Ready Clean Architecture Template for .NET

A powerful and reusable **Clean Architecture template** for .NET that helps developers bootstrap scalable, maintainable, and enterprise-grade applications in seconds using the dotnet new CLI.

---

## 🎯 Why CleanArch.Pro?

Setting up Clean Architecture repeatedly is time-consuming and error-prone.

**CleanArch.Pro solves this by:**

* Eliminating boilerplate setup

* Providing a standardized structure

* Enforcing separation of concerns

* Accelerating project startup time

👉 Focus on building features, not architecture setup.

---

## ✨ Key Features

### 🧱 Layered Architecture

* **API Layer** → Entry point (Controllers, Middleware)

* **Application Layer** → Business logic, interfaces, services

* **Domain Layer** → Core entities, rules, abstractions

* **Infrastructure Layer** → Database, external services

---

### ⚡ Out-of-the-box Setup

* Dependency Injection configured

* Clean folder structure

* Ready-to-run Web API

* Swagger integrated

---

### 🧩 Design Patterns Included

* Repository Pattern

* Unit of Work

* Service Layer abstraction

---

### 🌐 Developer Experience

* CLI-based project creation

* Consistent naming conventions

* Minimal setup required

---

## 📦 Installation

Install the template globally:

dotnet new install CleanArch.Pro

---

## 🚀 Usage

Create a new project:

dotnet new clean-arch-pro -n MyApp

cd MyApp

Run the application:

dotnet run

---

## 🌐 Access Swagger UI

After running the app, open:

https://localhost:xxxx/swagger

👉 Explore API endpoints instantly.

---

## 📂 Project Structure

MyApp/

├── MyApp.API

├── MyApp.Application

├── MyApp.Domain

├── MyApp.Infrastructure

└── MyApp.sln

---

## 🧠 Architecture Overview

### 🔹 Domain Layer

* Core business entities

* Business rules

* No external dependencies

---

### 🔹 Application Layer

* Use cases

* Interfaces (IRepository, IService)

* DTOs & business logic orchestration

---

### 🔹 Infrastructure Layer

* Database access (EF Core or others)

* External integrations

* Repository implementations

---

### 🔹 API Layer

* Controllers

* Middleware (Exception handling)

* Dependency injection setup

---

## 🔄 Request Flow

Client → API → Application → Domain → Infrastructure → Database

---

## 🛠️ Technologies Used

* .NET 8 / 9 / 10

* ASP.NET Core Web API

* Dependency Injection

* Swagger (OpenAPI)

---

## 🧪 Testing the Template

dotnet new clean-arch-pro -n TestApp

cd TestApp

dotnet build

dotnet run

---

## ⚙️ Customization

You can easily extend:

* Add Authentication (JWT)

* Integrate logging (Serilog)

* Add caching layer

* Implement CQRS

* Add MediatR

---

## 🚀 Roadmap

* 🔐 JWT Authentication

* 📊 Logging (Serilog)

* ⚡ Caching support

* 🧵 CQRS + MediatR

* 🧪 Unit test project template

* 🐳 Docker support

---

## ⚠️ Requirements

* .NET SDK 8.0 or higher

* Visual Studio / VS Code (optional)

---

## 📜 License

This project is licensed under the MIT License.

---

## 👨‍💻 Author

**Abhishek**

.NET Developer

---

## ⭐ Support & Feedback

If you found this useful:

* ⭐ Star the repository

* 🔁 Share with your network

* 💬 Provide feedback / suggestions

---

## 🚀 Quick Start Summary

dotnet new install CleanArch.Pro

dotnet new clean-arch-pro -n MyApp

cd MyApp

dotnet run

---

## 💡 Final Note

CleanArch.Pro is designed to help developers:

* Start faster

* Build cleaner systems

* Maintain scalable architecture

👉 Built for developers who care about structure, clarity, and long-term maintainability.

---