README

Vertical Slice Architecture for Laravel — group your code by business feature, scale to hundreds of models without losing your mind.

Status: v0.1 — early access. Public API may change before v1.0.

Requirements

• PHP 8.3+
• Laravel 12+

Installation

composer require svidskiy/laravel-modulith
php artisan modulith:install

Create a module

php artisan module:make Billing

Scaffolds modules/Billing/:

modules/Billing/
├── Http/Controllers/
├── Models/
├── database/migrations/
└── routes/

Anything you drop inside is auto-loaded — no manual provider registration.

Commands

Configuration

config/modulith.php after modulith:install:

return [
    'path' => 'modules',          // base_path(...) prefix or absolute
    'namespace' => 'Modules',     // PSR-4 root for module classes
    'cache' => ['enabled' => env('MODULITH_CACHE', true)],
    'auto_discover' => [
        'config' => true,
        'routes' => true,
        'views' => true,
        'translations' => true,
        'migrations' => true,
        'commands' => true,
        'blade_components' => true,
        'policies' => true,
        'events' => true,
        'observers' => true,
        'middleware' => true,
    ],
];

What gets auto-loaded per module

License

MIT