README

Modularize helps you organize large Laravel applications into self-contained modules — each with its own controllers, models, migrations, routes, and service providers.

Instead of scattering related code across app/Http/Controllers, app/Models, and database/migrations, you group everything by feature: modules/Auth/, modules/Billing/, modules/Notifications/. Each module is independently navigable, testable, and replaceable — without changing how Laravel loads your application.

Requirements

• PHP 8.2+
• Laravel 10, 11, or 12

Installation

composer require norbybaru/modularize

Configuration

Publish the package configuration:

php artisan vendor:publish --provider="NorbyBaru\Modularize\ModularizeServiceProvider"

Autoloading

Add the Modules namespace to your composer.json and run composer dump-autoload:

{
    "autoload": {
        "psr-4": {
            "App\\": "app/",
            "Modules\\": "modules/"
        }
    }
}

Config options

The published config file (config/modularize.php) exposes the following options:

When enable is true, modules are automatically discovered and booted — no manual registration required.

Creating Your First Module

Generate a model with all related files in one command:

php artisan module:make:model User --module=Auth --all

This creates the following structure:

modules/
└── Auth/
    ├── Controllers/
    │   └── UserController.php
    ├── Database/
    │   ├── Factories/
    │   │   └── UserFactory.php
    │   ├── Migrations/
    │   │   └── <timestamp>_create_users_table.php
    │   └── Seeders/
    │       └── UserSeeder.php
    ├── Models/
    │   └── User.php
    └── Policies/
        └── UserPolicy.php

Command Reference

Module Management

Generators

All generator commands accept --module=<name> to specify the target module and --force to overwrite an existing file. If --module is omitted, you will be prompted interactively with autocomplete.

Contributing

Contributions are welcome. Fork the repository, create a branch off master, and open a pull request.

License

MIT — see LICENSE.md.