yunkeweb/laravel-ddd

Laravel DDD modular monolith scaffolding and architecture helpers.

v0.1.0 2026-05-29 11:14 UTC

Requires

• php: ^8.4
• illuminate/console: ^11.0||^12.0||^13.0
• illuminate/contracts: ^11.0||^12.0||^13.0
• illuminate/filesystem: ^11.0||^12.0||^13.0
• illuminate/support: ^11.0||^12.0||^13.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/boost: ^2.0
• laravel/pint: ^1.14
• nunomaduro/collision: ^8.8
• orchestra/testbench: ^11.0.0||^10.0.0||^9.0.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• spatie/laravel-ray: ^1.35

Suggests

• spatie/laravel-data: Required when generating DTOs with php artisan ddd:action --dto=spatie.

MIT

• yunkeweb

• laravel
• laravel-ddd
• yunkeweb

README

Laravel modular monolith DDD scaffolding, architecture helpers, and Laravel Boost resources.

Installation

composer require yunkeweb/laravel-ddd --dev
php artisan ddd:install

The install command publishes config/ddd.php, publishes customizable stubs to stubs/vendor/laravel-ddd, and adds the default PSR-4 mapping:

"Src\\": "src/"

Optional install flags:

php artisan ddd:install --no-stubs
php artisan ddd:install --no-autoload
php artisan ddd:install --force

--dto=spatie generates DTOs that extend Spatie\LaravelData\Data. Install spatie/laravel-data before using that option:

composer require spatie/laravel-data

Commands

php artisan ddd:module Identity
php artisan ddd:action Identity LoginWithPassword
php artisan ddd:action Identity LoginWithPassword --dto=spatie
php artisan ddd:repository Identity User
php artisan ddd:repository Identity User --no-bind
php artisan ddd:controller Identity LoginController
php artisan ddd:architecture-test

Laravel Boost

This package ships Boost guidelines and the laravel-ddd-architecture skill from resources/boost.

php artisan boost:install --discover
php artisan boost:update --discover

Architecture

• Domain stays pure PHP.
• Application coordinates use cases.
• Infrastructure adapts Laravel, packages, persistence, and external services.
• Presentation handles HTTP, console, requests, and resources.
• Interface bindings belong in each module's Infrastructure provider.
• Mature Laravel packages can be integrated when they fit; package-specific code stays outside Domain.

Testing

composer test