https://github.com/nwidart/laravel-modules
Module Management In Laravel
https://github.com/nwidart/laravel-modules
architecture hacktoberfest laravel laravel-modules php
Last synced: 6 months ago
JSON representation
Module Management In Laravel
- Host: GitHub
- URL: https://github.com/nwidart/laravel-modules
- Owner: nWidart
- License: mit
- Created: 2016-06-27T21:01:29.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-05-07T14:05:20.000Z (6 months ago)
- Last Synced: 2025-05-08T14:45:20.306Z (6 months ago)
- Topics: architecture, hacktoberfest, laravel, laravel-modules, php
- Language: PHP
- Homepage: https://docs.laravelmodules.com
- Size: 2.16 MB
- Stars: 5,771
- Watchers: 152
- Forks: 991
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
# Laravel-Modules
[](https://packagist.org/packages/nwidart/laravel-modules)
[](LICENSE.md)
[](https://scrutinizer-ci.com/g/nWidart/laravel-modules/?branch=master)
[](https://packagist.org/packages/nwidart/laravel-modules)
| **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](https://github.com/pingpong-labs/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](https://laravelmodules.com/docs/v11/upgrade) on official document.
## Install
To install via Composer, run:
``` bash
composer require nwidart/laravel-modules
```
The package will automatically register a service provider and alias.
Optionally, publish the package's configuration file by running:
``` bash
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:
```json
"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/](https://laravelmodules.com/docs).
## 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](https://discord.gg/hkF7BRvRZK) For quick help, ask questions in the appropriate channel.
## Credits
- [Nicolas Widart](https://github.com/nwidart)
- [David Carr](https://github.com/dcblogdev)
- [gravitano](https://github.com/gravitano)
- [All Contributors](../../contributors)
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.