Laravel DDD Maker

A single Artisan command that scaffolds a complete Clean Architecture + DDD feature in seconds — Request, Action, UseCase, Service, Repository, Output DTO, and Response — all with proper namespaces, interfaces, and PSR-12 compliant code.

Requirements

Installation

composer require imran-ahmed-optilius/laravel-ddd-maker --dev

Laravel's auto-discovery will register the service provider automatically.

Usage

Interactive wizard

php artisan make:feature

The command walks you through everything step by step:

╔═══════════════════════════════════════════════════╗
║  Laravel DDD Maker  by imran-ahmed-optilius        ║
║  Clean Architecture + Domain-Driven Design         ║
╚═══════════════════════════════════════════════════╝

  Enter the file prefix (e.g. ForHomePageTeacherGet):
  > ForHomePageTeacherGet

  Enter the feature folder name (e.g. HomePage):
  > HomePage

  ── Custom Names ──────────────────────────────────
  Press ENTER to accept the default ForHomePageTeacherGet* naming.

  Request class [default: ForHomePageTeacherGetRequest]:
  >

  Response(s) — use a custom or multiple names? (yes/no) [no]:
  > no

  Output DTO(s) — use a custom or multiple names? (yes/no) [no]:
  > no

  Repository(ies) — use a custom or multiple names? (yes/no) [no]:
  > no

  ── Files to be generated ─────────────────────────
    • app/Http/Requests/Api/V1/HomePage/ForHomePageTeacherGetRequest.php
    • app/Http/Controllers/Api/V1/HomePage/ForHomePageTeacherGetAction.php
    • app/UseCases/HomePage/IForHomePageTeacherGetUseCase.php
    • app/UseCases/HomePage/ForHomePageTeacherGetUseCase.php
    • app/Domain/HomePage/Services/IForHomePageTeacherGetService.php
    • app/Infra/HomePage/Services/ForHomePageTeacherGetService.php
    • app/Domain/HomePage/Repositories/IForHomePageTeacherGetRepository.php
    • app/Infra/HomePage/Repositories/ForHomePageTeacherGetRepository.php
    • app/Domain/HomePage/Services/Output/ForHomePageTeacherGetOutput.php
    • app/Http/Responses/Api/V1/HomePage/IForHomePageTeacherGetResponse.php
    • app/Http/Responses/Api/V1/HomePage/ForHomePageTeacherGetResponse.php

  Generate all files now? (yes/no) [yes]:
  > yes

  ── Generating ────────────────────────────────────
  ✔ CREATED  app/Http/Requests/Api/V1/HomePage/ForHomePageTeacherGetRequest.php
  ✔ CREATED  app/Http/Controllers/Api/V1/HomePage/ForHomePageTeacherGetAction.php
  ...

  ── Add to AppServiceProvider::register() ─────────
  ...

  ── Add to routes/api.php ─────────────────────────
  Route::get('/for-home-page-teacher-get', App\Http\Controllers\Api\V1\HomePage\ForHomePageTeacherGetAction::class);

  Done! All files generated successfully.

With inline options (skips first two prompts)

php artisan make:feature --prefix=ForHomePageTeacherGet --folder=HomePage

Multiple repositories, outputs, or responses

When the wizard asks "use a custom or multiple names?", answer yes and enter each name one by one. Leave the input blank to finish.

Generated File Structure

app/
├── Http/
│   ├── Requests/Api/V1/{Folder}/
│   │   └── {Prefix}Request.php               ← FormRequest with rules()
│   ├── Controllers/Api/V1/{Folder}/
│   │   └── {Prefix}Action.php                ← Invokable controller
│   └── Responses/Api/V1/{Folder}/
│       ├── I{Response}.php                   ← Response interface
│       └── {Response}.php                    ← Response implementation
├── UseCases/{Folder}/
│   ├── I{Prefix}UseCase.php                  ← UseCase interface
│   └── {Prefix}UseCase.php                   ← UseCase implementation
├── Domain/{Folder}/
│   ├── Services/
│   │   ├── I{Prefix}Service.php              ← Domain Service interface
│   │   └── Output/
│   │       └── {Output}.php                  ← Output DTO
│   └── Repositories/
│       └── I{Repo}.php                       ← Repository interface
└── Infra/{Folder}/
    ├── Services/
    │   └── {Prefix}Service.php               ← Service implementation
    └── Repositories/
        └── {Repo}.php                        ← Eloquent repository

After Generation

1. Register bindings in AppServiceProvider

The command prints the exact snippet. Add it to the register() method:

use App\UseCases\HomePage\IForHomePageTeacherGetUseCase;
use App\UseCases\HomePage\ForHomePageTeacherGetUseCase;
// ... other imports

public function register(): void
{
    // Use Cases
    $this->app->bind(IForHomePageTeacherGetUseCase::class, ForHomePageTeacherGetUseCase::class);

    // Domain Services
    $this->app->bind(IForHomePageTeacherGetService::class, ForHomePageTeacherGetService::class);

    // Repositories
    $this->app->bind(IForHomePageTeacherGetRepository::class, ForHomePageTeacherGetRepository::class);

    // Responses
    $this->app->bind(IForHomePageTeacherGetResponse::class, ForHomePageTeacherGetResponse::class);
}

2. Register the route in routes/api.php

The command prints this too:

Route::get('/for-home-page-teacher-get', \App\Http\Controllers\Api\V1\HomePage\ForHomePageTeacherGetAction::class);

3. Fill in the TODO placeholders

Each generated file has clearly marked TODO comments:

• rules() in the Request class — add your validation rules
• Constructor properties + getters in the Output DTO
• toArrayResponse() mapping in the Response class
• Eloquent queries in the Repository implementation
• Field mapping in the Service implementation

Customising Stubs

All stubs live in vendor/imran-ahmed-optilius/laravel-ddd-maker/src/Stubs/*.stub.

If you want to permanently customise them for your project, copy the src/Stubs folder into your project and update StubRenderer::$stubPath to point to your copy, or publish them once support for php artisan vendor:publish is added in a future version.

Running Tests

composer install
vendor/bin/phpunit

Changelog

See CHANGELOG.md.

License

MIT — see LICENSE.