nwidart/laravel-modules

Laravel Module management

v12.0.3 2025-04-28 07:57 UTC

Requires

• php: >=8.2
• ext-dom: *
• ext-json: *
• ext-simplexml: *
• wikimedia/composer-merge-plugin: ^2.1

Requires (Dev)

• friendsofphp/php-cs-fixer: ^v3.52
• laravel/framework: ^v12.0
• laravel/pint: ^1.16
• mockery/mockery: ^1.6
• orchestra/testbench: ^v10.0
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^11.5.3|^12.0.
• spatie/phpunit-snapshot-assertions: ^5.0

MIT

• Nicolas Widart

• module
• modules
• rad
• laravel
• nwidart

README

Laravel	laravel-modules
5.4	^1.0
5.5	^2.0
5.6	^3.0
5.7	^4.0
5.8	^5.0
6.0	^6.0
7.0	^7.0
8.0	^8.0
9.0	^9.0
10.0	^10.0
11.0	^11.0
12.0	^12.0

nwidart/laravel-modules is a Laravel package created to manage your large Laravel app using modules. A Module is like a Laravel package, it has some views, controllers or models. This package is supported and tested in Laravel 11.

This package is a re-published, re-organised and maintained version of pingpong/modules, which isn't maintained anymore.

With one big bonus that the original package didn't have: tests.

upgrade

To upgrade to version V11 follow Upgrade Guide on official document.

Install

To install via Composer, run:

composer require nwidart/laravel-modules

The package will automatically register a service provider and alias.

Optionally, publish the package's configuration file by running:

php artisan vendor:publish --provider="Nwidart\Modules\LaravelModulesServiceProvider"

Autoloading

By default, the module classes are not loaded automatically. You can autoload your modules by adding merge-plugin to the extra section:

"extra": {
    "laravel": {
        "dont-discover": []
    },
    "merge-plugin": {
        "include": [
            "Modules/*/composer.json"
        ]
    }
},

Tip: don't forget to run composer dump-autoload afterwards.

Documentation

You'll find installation instructions and full documentation on https://laravelmodules.com/.

Demo

You can see a demo using Laravel Breeze at https://github.com/laravel-modules-com/breeze-demo

This is a complete application using Auth, Base and Profile modules.

Community

We also have a Discord community. https://discord.gg/hkF7BRvRZK For quick help, ask questions in the appropriate channel.

Credits

• Nicolas Widart
• David Carr
• gravitano
• All Contributors

License

The MIT License (MIT). Please see License File for more information.