3.0.1

What's Changed

• Fix deprecation warning by @inxilpro in #130

Full Changelog: 3.0.0...3.0.1

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:

Plugin	Responsibility
ModulesPlugin	Discovers composer.json files and creates ModuleConfig instances
RoutesPlugin	Loads route files from modules
ViewPlugin	Registers view namespaces
BladePlugin	Registers Blade components with module namespaces
TranslatorPlugin	Registers translation namespaces and JSON paths
EventsPlugin	Discovers and registers event listeners
MigratorPlugin	Registers migration paths
GatePlugin	Auto-registers model policies
ArtisanPlugin	Registers console commands

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

3.0.0-beta.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:

Plugin	Responsibility
ModulesPlugin	Discovers composer.json files and creates ModuleConfig instances
RoutesPlugin	Loads route files from modules
ViewPlugin	Registers view namespaces
BladePlugin	Registers Blade components with module namespaces
TranslatorPlugin	Registers translation namespaces and JSON paths
EventsPlugin	Discovers and registers event listeners
MigratorPlugin	Registers migration paths
GatePlugin	Auto-registers model policies
ArtisanPlugin	Registers console commands

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

3.0.0-alpha.5

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

3.0.0-alpha.4

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

3.0.0-alpha.3

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

3.0.0-alpha.2

Moved Modularize helper trait to separate package.

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

3.0.0-alpha.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:

Plugin	Responsibility
ModulesPlugin	Discovers composer.json files and creates ModuleConfig instances
RoutesPlugin	Loads route files from modules
ViewPlugin	Registers view namespaces
BladePlugin	Registers Blade components with module namespaces
TranslatorPlugin	Registers translation namespaces and JSON paths
EventsPlugin	Discovers and registers event listeners
MigratorPlugin	Registers migration paths
GatePlugin	Auto-registers model policies
ArtisanPlugin	Registers console commands

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

2.3.0

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

2.2.1

What's Changed

• Fix deprecated function signature by @da-mask in #63
• Fix PHP 8.4 deprecations by @ejunker in #106
• Enhance documentation for retrieving translations. by @zobay in #100
• Add void return type to migration stub by @michaelconnelly in #103

New Contributors

• @da-mask made their first contribution in #63
• @zobay made their first contribution in #100
• @michaelconnelly made their first contribution in #103

Full Changelog: 2.2.0...2.3.0