internachi/modular

Modular 3.0 is a mostly backwards-compatible rewrite of much of the modular core.

Plugin-Based Architecture

Modular 3.0 introduces a plugin-based architecture that replaces the monolithic service provider with focused, composable plugin classes. This architectural refactoring improves extensibility, testability, and separation of concerns.

Built-in Plugins

Each aspect of module auto-discovery is now handled by a dedicated plugin:

Registering Custom Plugins

Third-party packages or application code can register custom plugins:

use InterNACHI\Modular\PluginRegistry;

PluginRegistry::register(MyCustomPlugin::class);

Custom plugins will be automatically integrated into the caching system and can use the attribute-based lifecycle controls.

Plugin Lifecycle

Each plugin implements a two-phase lifecycle:

1. discover() - Scans the filesystem and returns serializable discovery data
2. handle() - Processes the discovered data (registers with Laravel services)

PHP 8 attributes control when plugins execute:

use InterNACHI\Modular\Plugins\Attributes\AfterResolving;

#[AfterResolving(BladeCompiler::class)]
class BladePlugin extends Plugin
{
    // Only runs when BladeCompiler is resolved
}

Unified Caching

The modules:cache command now caches all plugin discovery data in a single file (bootstrap/cache/app-modules.php). This simplifies cache invalidation and reduces filesystem operations during bootstrapping.

Laravel 11+ & PHP 8.3+

Modular 3.0 requires Laravel 11 or later and PHP 8.3 or later. This allows us to leverage modern PHP features like attributes and constructor property promotion throughout the codebase.

Streamlined Dependencies

The Livewire integration has been moved to a separate package to keep the core package focused and reduce dependencies.

Breaking Changes

Please see the Upgrade Guide for a complete list of breaking changes and migration instructions.

Full Changelog: 2.3.0...3.0.0

Modular 3.0 is a mostly backwards-compatible rewrite of much of the modular core.

Plugin-Based Architecture

Modular 3.0 introduces a plugin-based architecture that replaces the monolithic service provider with focused, composable plugin classes. This architectural refactoring improves extensibility, testability, and separation of concerns.

Built-in Plugins

Each aspect of module auto-discovery is now handled by a dedicated plugin:

Registering Custom Plugins

Third-party packages or application code can register custom plugins:

use InterNACHI\Modular\PluginRegistry;

PluginRegistry::register(MyCustomPlugin::class);

Custom plugins will be automatically integrated into the caching system and can use the attribute-based lifecycle controls.

Plugin Lifecycle

Each plugin implements a two-phase lifecycle:

1. discover() - Scans the filesystem and returns serializable discovery data
2. handle() - Processes the discovered data (registers with Laravel services)

PHP 8 attributes control when plugins execute:

use InterNACHI\Modular\Plugins\Attributes\AfterResolving;

#[AfterResolving(BladeCompiler::class)]
class BladePlugin extends Plugin
{
    // Only runs when BladeCompiler is resolved
}

Unified Caching

The modules:cache command now caches all plugin discovery data in a single file (bootstrap/cache/app-modules.php). This simplifies cache invalidation and reduces filesystem operations during bootstrapping.

Laravel 11+ & PHP 8.3+

Modular 3.0 requires Laravel 11 or later and PHP 8.3 or later. This allows us to leverage modern PHP features like attributes and constructor property promotion throughout the codebase.

Streamlined Dependencies

The Livewire integration has been moved to a separate package to keep the core package focused and reduce dependencies.

Breaking Changes

Please see the Upgrade Guide for a complete list of breaking changes and migration instructions.

New Contributors

• @samlev made their first contribution in #110
• @cheyner made their first contribution in #108

Full Changelog: 2.2.1...3.0.0-beta.1

Full Changelog: 3.0.0-alpha.4...3.0.0-alpha.5

Full Changelog: 3.0.0-alpha.3...3.0.0-alpha.4

Full Changelog: 3.0.0-alpha.2...3.0.0-alpha.3

Moved Modularize helper trait to separate package.

Full Changelog: 3.0.0-alpha.1...3.0.0-alpha.2

Modular 3.0 is a mostly backwards-compatible rewrite of much of the modular core.

Plugin-Based Architecture

Modular 3.0 introduces a plugin-based architecture that replaces the monolithic service provider with focused, composable plugin classes. This architectural refactoring improves extensibility, testability, and separation of concerns.

Built-in Plugins

Each aspect of module auto-discovery is now handled by a dedicated plugin:

Registering Custom Plugins

Third-party packages or application code can register custom plugins:

use InterNACHI\Modular\PluginRegistry;

PluginRegistry::register(MyCustomPlugin::class);

Custom plugins will be automatically integrated into the caching system and can use the attribute-based lifecycle controls.

Plugin Lifecycle

Each plugin implements a two-phase lifecycle:

1. discover() - Scans the filesystem and returns serializable discovery data
2. handle() - Processes the discovered data (registers with Laravel services)

PHP 8 attributes control when plugins execute:

use InterNACHI\Modular\Plugins\Attributes\AfterResolving;

#[AfterResolving(BladeCompiler::class)]
class BladePlugin extends Plugin
{
    // Only runs when BladeCompiler is resolved
}

Unified Caching

The modules:cache command now caches all plugin discovery data in a single file (bootstrap/cache/app-modules.php). This simplifies cache invalidation and reduces filesystem operations during bootstrapping.

Laravel 11+ & PHP 8.3+

Modular 3.0 requires Laravel 11 or later and PHP 8.3 or later. This allows us to leverage modern PHP features like attributes and constructor property promotion throughout the codebase.

Streamlined Dependencies

The Livewire integration has been moved to a separate package to keep the core package focused and reduce dependencies.

Breaking Changes

Please see the Upgrade Guide for a complete list of breaking changes and migration instructions.

Full Changelog: 2.3.0...3.0.0-alpha.1

What's Changed

• Fix getApplicationBasePath naming in testbench by @inxilpro in #111
• Handle the renamed static property in Factory by @samlev in #110
• Add Laravel 12 support + tests by @inxilpro in #112
• Using conventional directories for default test by @cheyner in #108

New Contributors

• @samlev made their first contribution in #110
• @cheyner made their first contribution in #108

Full Changelog: 2.2.1...2.3.0

Added

• The modules sync command now adds modules to PhpStorm exclude path, preventing double-registration of modules

Added

• Added support for Laravel 11
• Added support for event discovery

Fixed

• Fixed an error with how module command signatures were set

Changed

• Dropped support for older versions of PHP and Laravel. If you are using Laravel 7 or 8, or PHP 7, please use the 1.x releases

Added

• Added support for factory model name resolution inside modules

Fixed

• Added support for new make:command changes in Laravel 10

Changed

• Updated version constraints to add Laravel 10 support and drop automated testing for old versions of PHP and Laravel

Fixed

• Improved path normalization on Windows (thanks to @Sophist-UK)

Fixed

• Addressed issue where make:migration and make:livewire were not loading the custom --module option
• Added additional tests for make: commands to catch necessary changes quicker in the future
• Passing a --module flag for an unknown module now triggers a console error

Added

• Added support for Blade component namespaces (i.e. <x-module::component.name />)

Fixed

• Fixed issue with make:seeder command introduced in Laravel 9.6.0

Added

• Added support for Laravel 9.x

Added

• Added support for custom module stubs

Fixed

• Only register the make:livewire integration if Livewire is installed

Added

• Added support for syncing modules to PhpStorm library roots

Added

• Added support for make:cast

Added

• Added support for Livewire's make:livewire command

Added

• Added support for --module in php artisan db:seed

Fixed

• Create seeders in the correct namespace when --module flag is used in Laravel 8+
• Create factories in the correct namespace when --module flag is used in Laravel 8+
• Apply module namespace to models when creating a factory in a module

Fixed

• Added better handling of missing directories

Added

• Added support for translations in modules

Changed

• Switched to diglactic/laravel-breadcrumbs for breadcrumbs check

Added

• Added better patching for PHPStorm config files to minimize diffs

Added

• Support for auto-registering Laravel 8 factory classes

Fixed

• Better Windows support
• Support for composer 2.0
• Improves the file scanning efficiency of the AutoDiscoveryHelper

Added

• Adds support for php artisan make:component
• php artisan modules:sync will now update additional PhpStorm config files
• Partial support for --all on make:model
• Initial support for component auto-discovery
• Switched to single app-modules/* composer repository rather than new repositories for each module
• Added description field to generated composer.json file
• Moved tests from autoload-dev to autoload because composer doesn't support autoload-dev for non-root configs
• Added improved support for Laravel 8 factory classes

Changed

• Introduces a few improvements to the default composer.json format.

Added

• Initial release

"Keep a Changelog" - Types of Changes

• Added for new features.
• Changed for changes in existing functionality.
• Deprecated for soon-to-be removed features.
• Removed for now removed features.
• Fixed for any bug fixes.
• Security in case of vulnerabilities.