CleanArch.Generator 1.0.125

🧱 Clean Architecture Template for .NET

This template generates a project based on Clean Architecture using .NET, with a clear separation of concerns. It simplifies development, testing, and long-term maintenance.

🚀 Features

• ✅ Well-structured layered architecture: API, Application, Domain, Infrastructure
• 📦 Professional folder structure with logical separation of responsibilities
• 🧪 High testability and support for unit testing
• ⚙️ Built with the latest .NET version (net8.0)
• 🧰 Easily extensible and customizable for various application types (Web API, Microservices, etc.)

⚙️ Installation & Usage (PowerShell)

🖥️ All commands below should be run using PowerShell
🛠️ The generator tool is installed once globally on your machine.

1. Install the Generator Tool (one-time setup)

dotnet tool install --global CleanArch.Generator --version 1.0.118 --add-source "C:\Your\Path"

2. Create a New Project for Any .NET Version

First, create a new folder for your project and navigate into it using PowerShell:

mkdir MyNewProject
cd MyNewProject

Then generate the project using:

cleanarch-gen new --name MyNewProject --framework net8.0

💡 If --framework is not specified, the latest available .NET version will be used by default.

🗂️ Project Structure

MyNewProject/
└── src/
    ├── MyNewProject.API/               # طبقة العرض (Controllers + Middleware)
    │   ├── Controllers/
    │   │   └── BaseController.cs
    │   ├── Middleware/
    │   │   └── ExceptionMiddleware.cs
    │   └── MyNewProject.API.csproj
    │
    ├── MyNewProject.Domain/            # الكيانات وواجهات التجريد
    │   ├── Entites/
    │   │   └── BaseEntity.cs
    │   ├── Interface/
    │   │   ├── IRepository.cs
    │   │   └── IUnitOfWork.cs
    │   └── MyNewProject.Domain.csproj
    │
    ├── MyNewProject.Application/       # منطق الأعمال، الخدمات، DTOs
    │   ├── Base/
    │   │   └── BaseService.cs
    │   ├── Interface/
    │   │   └── IService.cs
    │   ├── Implement/
    │   │   └── Service.cs
    │   ├── DTOs/
    │   │   ├── RequestDTO.cs
    │   │   └── ResponseDTO.cs
    │   └── MyNewProject.Application.csproj
    │
    ├── MyNewProject.Infrastructure/    # تنفيذ المستودعات، DbContext
    │   ├── Data/
    │   │   └── AppDbContext.cs
    │   ├── Repository/
    │   │   ├── Repository.cs
    │   │   └── UnitOfWork.cs
    │   └── MyNewProject.Infrastructure.csproj
    │
    └── MyNewProject.sln                # ملف الحل الأساسي

🧩 Layer Explanation

▶️ Run the Project

cd MyNewProject
dotnet run

Then navigate to: https://localhost:7025

🧪 Extensibility & Testing

You can add a test project (e.g., MyNewProject.Tests) to cover business logic and infrastructure.

Recommended tools:

• xUnit
• NUnit
• Moq

📌 Notes

• Suitable for teams adopting Separation of Concerns
• Fully customizable to fit your team's style or environment
• Designed with best practices for enterprise-grade software development

📬 Contributing

Contributions are welcome! Whether it’s a suggestion, improvement, or bug fix — feel free to submit a pull request.

📄 License

This project is licensed under the MIT License. You are free to use, modify, and distribute it with attribution.

🔗 NuGet Package:
https://www.nuget.org/packages/CleanArch.Generator