PHPackages                             plin-code/laravel-clean-architecture - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. plin-code/laravel-clean-architecture

ActiveLibrary[Utility & Helpers](/categories/utility)

plin-code/laravel-clean-architecture
====================================

Laravel package for generating Clean Architecture structure

v2.0.2(4mo ago)74.0kMITPHPPHP ^8.3CI failing

Since Mar 31Pushed 4mo agoCompare

[ Source](https://github.com/plin-code/laravel-clean-architecture)[ Packagist](https://packagist.org/packages/plin-code/laravel-clean-architecture)[ RSS](/packages/plin-code-laravel-clean-architecture/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (3)Dependencies (9)Versions (4)Used By (0)

🏗️ Laravel Clean Architecture Package
=====================================

[](#️-laravel-clean-architecture-package)

A Laravel package to easily implement Clean Architecture in your projects. 🚀

[![Latest Version on Packagist](https://camo.githubusercontent.com/6a7a870c049e0c4522af6f927d6da2f1c463216437dfbfdae3bf209227f9330d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f706c696e2d636f64652f6c61726176656c2d636c65616e2d6172636869746563747572652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/plin-code/laravel-clean-architecture)[![GitHub Tests Action Status](https://camo.githubusercontent.com/7b5fac2d46242c272500c1e674d77a87923479a4752d93cc00aee8387a1d8479/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f706c696e2d636f64652f6c61726176656c2d636c65616e2d6172636869746563747572652f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/plin-code/laravel-clean-architecture/actions?query=workflow%3ATests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/da900c28b88bfaedfd4025e9af5d5377e580da1642e5eb0e013fe898d541f4b8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f706c696e2d636f64652f6c61726176656c2d636c65616e2d6172636869746563747572652f636f64652d7374796c652d6669782e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/plin-code/laravel-clean-architecture/actions?query=workflow%3A%22Code+Style+%28Auto-fix%29%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/1bc189f56ff77d41daa30492ef6d3f35ca0db41111ad9e72f9b4143b7db1fa80/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f706c696e2d636f64652f6c61726176656c2d636c65616e2d6172636869746563747572652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/plin-code/laravel-clean-architecture)

✨ Features
----------

[](#-features)

- 🎯 **Domain-Driven Design** - Organize your code with DDD principles
- ⚡ **Quick Setup** - Get started with Clean Architecture in minutes
- 🧩 **Auto-Generation** - Generate complete domains with one command
- 🏛️ **Layer Separation** - Clear separation between Domain, Application, and Infrastructure
- 🔧 **Customizable** - Flexible configuration to fit your project needs
- 🧪 **Test-Ready** - Pre-built test templates for immediate testing
- 📚 **Well-Documented** - Comprehensive documentation and examples
- 🎨 **Modern PHP** - Built for PHP 8.3+ with latest Laravel features

📋 Requirements
--------------

[](#-requirements)

- 🐘 PHP 8.3+
- ⚡ Laravel 12.x / 13.x

📦 Installation
--------------

[](#-installation)

```
composer require plin-code/laravel-clean-architecture
```

⚙️ Configuration
----------------

[](#️-configuration)

Publish the configuration files and stubs:

```
php artisan vendor:publish --provider="PlinCode\LaravelCleanArchitecture\CleanArchitectureServiceProvider"
```

🎯 Usage
-------

[](#-usage)

### 🏗️ Installing Clean Architecture structure

[](#️-installing-clean-architecture-structure)

```
php artisan clean-arch:install
```

This command will create:

- 📁 Folder structure for Domain, Application and Infrastructure layers
- 🧩 Base classes (BaseModel, BaseAction, BaseService, etc.)
- ⚙️ Configuration file
- 📖 Documentation

### 🆕 Creating a new domain

[](#-creating-a-new-domain)

```
php artisan clean-arch:make-domain User
```

This command will generate:

- 🏛️ Domain model with events
- 📊 Status enums
- 🔔 Domain events (Created, Updated, Deleted)
- ⚡ Actions (Create, Update, Delete, GetById)
- 🔧 Service
- 🌐 API Controller
- 📝 Form Requests (Create, Update)
- 📤 API Resource
- 🗃️ Database migration
- 🧪 Feature tests

After generating the core files, `make-domain` prompts interactively for optional components. You can choose to also generate an Observer, Listener, Job, Mail, Notification, and Export for the domain. Each prompt can be answered independently, so you only generate what your domain needs.

### ✅ Architecture validation

[](#-architecture-validation)

```
php artisan clean-arch:validate
```

This command checks your codebase for layer dependency violations (for example, Domain code importing from Infrastructure). It returns exit code 1 when violations are found, making it suitable for use in CI pipelines.

```
Clean Architecture Validation
=============================

  ✓ Domain has no Application imports
  ✓ Domain has no Infrastructure imports
  ✓ Application has no Infrastructure imports
  ✓ No Observers in Domain
  ✓ No Jobs in Infrastructure
  ✓ No Commands in Infrastructure
  ✓ No duplicate Services directory

No violations found.

```

### 🛠️ Available commands

[](#️-available-commands)

- `clean-arch:install` - 🏗️ Install Clean Architecture structure
- `clean-arch:make-domain {name}` - 🆕 Create a complete new domain
- `clean-arch:make-action {name} {domain}` - ⚡ Create a new action
- `clean-arch:make-service {name}` - 🔧 Create a new service
- `clean-arch:make-controller {name}` - 🌐 Create a new controller
- `clean-arch:make-observer {name} {domain}` - 👁️ Create a new observer
- `clean-arch:make-listener {name}` - 👂 Create a new listener
- `clean-arch:make-job {name}` - ⏳ Create a new job
- `clean-arch:make-mail {name}` - 📧 Create a new mailable
- `clean-arch:make-notification {name}` - 🔔 Create a new notification
- `clean-arch:make-export {name}` - 📤 Create a new export
- `clean-arch:validate` - ✅ Validate architecture dependency rules
- `clean-arch:generate-package {name} {vendor}` - 📦 Generate a new package

### 📂 Project structure after `clean-arch:install`

[](#-project-structure-after-clean-archinstall)

```
app/
├── Domain/                          # Pure business logic
├── Application/                     # Use cases and orchestration
│   ├── Actions/
│   ├── Services/
│   ├── Jobs/
│   ├── Listeners/
│   └── Console/Commands/
└── Infrastructure/                  # Framework adapters
    ├── Http/
    │   ├── Controllers/Api/
    │   ├── Middleware/
    │   ├── Requests/
    │   └── Resources/
    ├── UI/
    ├── Mail/
    ├── Notifications/
    ├── Observers/
    ├── Exports/
    ├── Validation/
    └── Exceptions/

```

### 📂 Generated structure after `clean-arch:make-domain User`

[](#-generated-structure-after-clean-archmake-domain-user)

```
app/
├── Domain/
│   └── Users/
│       ├── Models/
│       │   └── User.php
│       ├── Enums/
│       │   └── UserStatus.php
│       └── Events/
│           ├── UserCreated.php
│           ├── UserUpdated.php
│           └── UserDeleted.php
├── Application/
│   ├── Actions/
│   │   └── Users/
│   │       ├── CreateUserAction.php
│   │       ├── UpdateUserAction.php
│   │       ├── DeleteUserAction.php
│   │       └── GetByIdUserAction.php
│   └── Services/
│       └── UserService.php
└── Infrastructure/
    └── Http/
        ├── Controllers/
        │   └── Api/
        │       └── UsersController.php
        ├── Requests/
        │   ├── CreateUserRequest.php
        │   └── UpdateUserRequest.php
        └── Resources/
            └── UserResource.php

```

🏛️ Clean Architecture Principles
--------------------------------

[](#️-clean-architecture-principles)

This package implements Clean Architecture principles:

1. **🎯 Domain Layer**: Contains business logic and entities
2. **⚡ Application Layer**: Contains use cases and application logic
3. **🏗️ Infrastructure Layer**: Contains implementation details (controllers, database, etc.)

### 🔗 Dependencies

[](#-dependencies)

- **🎯 Domain Layer**: Does not depend on any other layer
- **⚡ Application Layer**: Depends only on Domain Layer
- **🏗️ Infrastructure Layer**: Depends on Application and Domain Layers

💡 Examples
----------

[](#-examples)

### 🛍️ Creating a Product domain

[](#️-creating-a-product-domain)

```
php artisan clean-arch:make-domain Product
```

### 🎮 Using in controller

[](#-using-in-controller)

```
class ProductsController extends Controller
{
    public function __construct(
        private CreateProductAction $createProductAction,
        private ProductService $productService
    ) {}

    public function store(CreateProductRequest $request): JsonResponse
    {
        $product = $this->createProductAction->execute($request);

        return response()->json([
            'data' => new ProductResource($product),
            'message' => 'Product created successfully'
        ], 201);
    }
}
```

⚙️ Configuration
----------------

[](#️-configuration-1)

The configuration file `config/clean-architecture.php` allows you to customize:

- 🏷️ Default namespace
- 📁 Directory paths
- ✅ Validation options
- 📊 Logging settings

🛠️ Development
--------------

[](#️-development)

This package uses several tools to maintain code quality:

### 🔧 Code Quality Tools

[](#-code-quality-tools)

- **🎨 Laravel Pint** - Code formatting and style fixing
- **🔍 PHPStan** - Static analysis for finding bugs
- **🧪 PEST** - Modern testing framework built on PHPUnit
- **🎭 Orchestra Testbench** - Laravel package testing

### 📜 Available Scripts

[](#-available-scripts)

```
# 🧪 Run tests
composer test

# 📊 Run tests with coverage
composer test-coverage

# 🎨 Fix code style
composer format

# 👀 Check code style without fixing
composer format-test

# 🔍 Run static analysis
composer analyse

# ✨ Run all quality checks
composer quality
```

### 🚀 Development Setup

[](#-development-setup)

1. 📥 Clone the repository
2. 📦 Install dependencies: `composer install`
3. ✨ Run quality checks: `composer quality`

🤝 Contributing
--------------

[](#-contributing)

Pull requests are welcome! 🎉 For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate and follow our [Contributing Guidelines](CONTRIBUTING.md). 📝

📄 License
---------

[](#-license)

[MIT](https://choosealicense.com/licenses/mit/) 📜

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance77

Regular maintenance activity

Popularity24

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

3

Last Release

125d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7653cedfb706bdbaceab17cb57fa55d5e2744faeb722cfc1e2af8c3fd88f13ef?d=identicon)[danielebarbaro](/maintainers/danielebarbaro)

---

Top Contributors

[![danielebarbaro](https://avatars.githubusercontent.com/u/4376886?v=4)](https://github.com/danielebarbaro "danielebarbaro (40 commits)")

---

Tags

phplaravelpackageDomain Driven Designdddclean architecture

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/plin-code-laravel-clean-architecture/health.svg)

```
[![Health](https://phpackages.com/badges/plin-code-laravel-clean-architecture/health.svg)](https://phpackages.com/packages/plin-code-laravel-clean-architecture)
```

###  Alternatives

[laravel/ai

The official AI SDK for Laravel.

1.1k4.6M281](/packages/laravel-ai)[illuminate/queue

The Illuminate Queue package.

20433.0M1.7k](/packages/illuminate-queue)[erag/laravel-lang-sync-inertia

A powerful Laravel package for syncing and managing language translations across backend and Inertia.js (Vue/React/Svelte) frontends, offering effortless localization, auto-sync features, and smooth multi-language support for modern Laravel applications.

5031.3k](/packages/erag-laravel-lang-sync-inertia)[moonshine/moonshine

Laravel administration panel

1.3k268.2k87](/packages/moonshine-moonshine)[tehwave/laravel-achievements

Simple, elegant Achievements the Laravel way

7213.1k](/packages/tehwave-laravel-achievements)[forjedio/inertia-table

Backend-driven dynamic tables for Laravel + Inertia.js

272.0k](/packages/forjedio-inertia-table)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)