Laravel Modules

A zero-config modular architecture package for Laravel. Create a Modules/ directory, drop in your module folders, and the package auto-discovers and registers everything: configs, routes, views, Blade components, migrations, seeders, commands, service providers, helpers, translations, models, factories, policies, events, listeners, Livewire components, Filament resources, and Nova resources.

Read the full documentation at mozex.dev: searchable docs, version requirements, detailed changelog, and more.

Introduction
Features
Integrations
- PHPStan
- PHPUnit
- Pest
- Inertia

Support This Project

I maintain this package along with several other open-source PHP packages used by thousands of developers every day.

If my packages save you time or help your business, consider sponsoring my work on GitHub Sponsors. Your support lets me keep these packages updated, respond to issues quickly, and ship new features.

Business sponsors get logo placement in package READMEs. See sponsorship tiers →

What You Get

Convention over configuration. Module directory names become view namespaces, Blade component prefixes, and translation keys. Modules/Blog/ gives you view('blog::home'), <x-blog::card />, and __('blog::messages.welcome') with no setup.

Everything auto-discovered. Routes load with the right middleware groups based on filename (web.php gets web middleware, api.php gets api prefix and middleware). Service providers register themselves. Commands appear in Artisan. Migrations run with php artisan migrate. Factories and policies resolve from models automatically.

Full Livewire v4 support. Class-based components, single-file components (SFC), and multi-file components (MFC) all work with namespaced aliases like <livewire:blog::editor />.

Filament v5 integration. Resources, pages, widgets, and clusters register with panels based on directory structure. Put a resource in Filament/Admin/Resources/ and it shows up in the admin panel.

Fine-grained control when you need it. Enable or disable individual modules, set load order, toggle specific features, and override discovery patterns. All from config/modules.php.

Production-ready caching. One command (php artisan modules:cache) caches all discovery results. No scanning on every request.

Installation

Requires PHP 8.3+ - see all version requirements

composer require mozex/laravel-modules

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

Regenerate the autoloader:

composer dump-autoload

Optionally publish the config to change defaults:

php artisan vendor:publish --tag=laravel-modules-config

Quick Start

Create a module with a route and a view:

Modules/
└── Blog/
    ├── Routes/
    │   └── web.php
    └── Resources/
        └── views/
            └── index.blade.php

The route file works like any Laravel route file:

use Illuminate\Support\Facades\Route;

Route::get('/blog', fn () => view('blog::index'));

That's a working module. The route loads with the web middleware group (because the file is named web.php) and the view is accessible through the blog:: namespace. Add more directories as you need them: Models/, Livewire/, Filament/Admin/Resources/, and so on. The package picks up each one based on the conventions documented in the feature guides.

For a complete module structure, configuration reference, facade API, and detailed feature documentation, visit the documentation site.

Resources

Visit the documentation site for searchable docs auto-updated from this repository.

AI Integration: Use this package with AI coding assistants via Context7 and Laravel Boost
Requirements: PHP, Laravel, and dependency versions
Changelog: Release history with linked pull requests and diffs
Contributing: Development setup, code quality, and PR guidelines
Questions & Issues: Bug reports, feature requests, and help
Security: Report vulnerabilities directly via email

License

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

Laravel Modules Laravel Package