internachi/modular

What's Changed

• Added Laravel 13 support
• fix: boost skill does not use correct module directory by @calebdw in #133
• Add option to skip updating phpunit in modules:sync command by @gvieira18 in #128

New Contributors

• @calebdw made their first contribution in #133
• @gvieira18 made their first contribution in #128

Full Changelog: 3.0.1...3.0.2

What's Changed

• Fix deprecation warning by @inxilpro in #130

Full Changelog: 3.0.0...3.0.1

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