README

Turn a Laravel application into a modular monolith. Modules are Composer packages that boot in topological dependency order, with an extra initialize() lifecycle phase between register() and boot() for cross-module coordination — plus architecture analysis commands for the module graph.

class CatalogServiceProvider extends ModuleProvider
{
    public function configureModule(Module $module): void
    {
        $module
            ->name('acme/catalog')
            ->hasConfig('catalog')
            ->hasRoutes('web', 'api')
            ->hasViews()
            ->hasMigrations()
            ->runsMigrations();
    }
}

Why

1. Topological provider ordering — module service providers are sorted by their composer.json dependencies, so a module always boots after the modules it depends on.
2. Enhanced lifecycle — register() → initialize() → boot(). The initialize() phase runs after every module is registered but before any boots, the right window for morph maps, permissions, drivers, and Livewire/Filament hooks.
3. Architecture tooling — module:graph, module:impact, module:why, module:list, with --format=json for CI gates.

Install

composer require happenv-com/laravel-true-modular

Then point bootstrap/app.php at the custom Application — see Getting started.

Requires PHP 8.3+ and Laravel 12/13.

Documentation

Full documentation lives in docs/:

Development

composer install
vendor/bin/pest             # tests (Pest 4)
vendor/bin/pint             # format
vendor/bin/phpstan analyse  # static analysis (level 6 + larastan)

License

See composer.json for license information.