samrat415/laravel-ddd

Laravel DDD Toolkit - A lightweight Laravel package to scaffold and manage Domain Driven Design (DDD) modules for APIs and Livewire frontends. Features automatic PSR-4 namespace registration, artisan commands for module creation, and seamless integration with Laravel Sail.

v1.0.0 2025-07-03 16:55 UTC

Requires

• php: ^8.1
• illuminate/contracts: ^10.0||^11.0||^12.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• laravel/pint: ^1.14
• nunomaduro/collision: ^8.1.1||^7.10.0
• orchestra/testbench: ^10.0.0||^9.0.0||^8.22.0
• pestphp/pest: ^3.0
• pestphp/pest-plugin-arch: ^3.0
• pestphp/pest-plugin-laravel: ^3.0

MIT

• samrat415

• laravel
• laravel-ddd
• samrat415

README

A Laravel package to scaffold and register Domain Driven Design (DDD) modules for APIs and Livewire frontends.

Features

• Auto-registers domains/, src/, and frontend/ PSR-4 namespaces
• Registers service providers automatically
• Artisan commands to setup folder structures and modules
• Supports portal-based domain APIs and frontend modules
• Optional interactive prompts for portal creation

Installation

composer require samrat415/laravel-ddd

Autoload

You do not need to manually add namespaces to composer.json — the package does it for you automatically.

Commands

1. Install base folders and portals

php artisan ddd:install

• Creates base folders: domains/, src/, frontend/ (if missing)
• Prompts to add portals for domains and frontend

2. Create a new domain module

php artisan ddd:domain {portal/module}

• Creates structure inside domains/{portal}/{module}, e.g.:

domains/Admin/Users/
├── Api/
├── Resources/
└── routes/v1.php

• If portal is omitted, prompts to select or create one.

3. Create a new src module

php artisan ddd:src {module}

• Creates structure inside src/{module}, e.g.:

src/Admin/
├── Controllers/
├── DTO/
├── Enums/
├── Livewire/       # only if livewire_support config enabled
├── Models/
├── Routes/web.php
├── Service/
└── Views/

• Does not ask for portal, just creates the module folders.

Folder Overview

domains/      # API domains organized by portal
frontend/     # Livewire & Blade UI modules by portal
src/          # Core business logic and services

License

MIT License © samrat415

Ongoing Updates

This package is actively evolving. Upcoming features include a Filament-like, but simpler, module generator that:

• Creates basic CRUD modules
• Follows Domain Driven Design (DDD) patterns
• Uses Livewire components
• Works with your existing database tables

Stay tuned for more improvements and new tools to speed up your Laravel DDD development!