# Changelog

**Package:** Laravel Modules | **Version:** 3 | **URL:** https://mozex.dev/docs/laravel-modules/v3/changelog

---

All notable changes to `laravel-modules` will be documented in this file.

## 3.5.0 - 2026-10-08

### What's Changed

* Drop Laravel 11 support
* Bump minimum `laravel/framework` requirement from `^11.29.0|^12.0|^13.0` to `^12.69.0|^13.30.0`
* Add the package banner and icon

Laravel 11 stopped receiving security fixes on March 12, 2026. Three advisories published since then ([GHSA-5vg9-5847-vvmq](https://github.com/advisories/GHSA-5vg9-5847-vvmq), [GHSA-crmm-hgp2-wgrp](https://github.com/advisories/GHSA-crmm-hgp2-wgrp) and [GHSA-jh5r-qr3c-85q8](https://github.com/advisories/GHSA-jh5r-qr3c-85q8)) affect every Laravel 11 release and were fixed only in Laravel 12 and 13. The new minimums, 12.69.0 and 13.30.0, are the first releases that include all three fixes.

If your app is still on Laravel 11, Composer keeps you on 3.4.1.

**Full Changelog**: [3.4.1...3.5.0](https://github.com/mozex/laravel-modules/compare/3.4.1...3.5.0)

## 3.4.1 - 2026-10-04

### What's Changed

* Improve package setup

**Full Changelog**: [3.4.0...3.4.1](https://github.com/mozex/laravel-modules/compare/3.4.0...3.4.1)

## 3.4.0 - 2026-08-01

### What's new

**`php artisan optimize` now builds the module cache.** The package registers `modules:cache` and `modules:clear` with Laravel's optimize system, so any deploy script that runs `optimize` (or `optimize:clear`) covers module discovery automatically. No more forgetting `modules:cache` in a deploy and silently paying full filesystem discovery on every request. Skip it with `--except=modules` if you need to.

**Blade component aliases are computed at cache time.** The scout now stores each component's alias in the cache payload, so registering components no longer runs `realpath()` and regex work per component on every request. Old cache files without the alias key keep working through a runtime fallback.

> After upgrading, rebuild the module cache (`php artisan modules:cache` or `php artisan optimize`) to pick up the new payload.

**Faster name guessing.** The model, factory, and policy guessers now re-register the same closure instead of rebuilding it after every fallback guess, hoist their reflection lookups, and memoize module-name guesses. Apps that authorize non-module models or build factories in loops no longer pay reflection plus closure allocation per call.

**Leaner web requests.** Command and migration discovery moved inside `Artisan::starting()` and the migrator's resolving hook, so web requests skip that scout work entirely. `Artisan::call()` from HTTP and queue workers behave exactly as before.

**Smaller dependency tree.** Class scanning no longer uses `->parallel()`, which ran on single-process fibers and provided no actual parallelism (measured about 5% slower than the synchronous path). The direct `amphp/parallel` requirement is gone, removing around a dozen transitive packages from your vendor directory.

### Fixes

- Filament scouts with multiple discovery patterns no longer throw "Panel not found" for assets matched by any pattern after the first.
- Guessing a model name for a non-module factory no longer emits a PHP 8.3 `ReflectionProperty::setValue()` deprecation.
- The `Modules` service is now pinned into the container as a shared instance, so injecting `Mozex\Modules\Modules` sees the same route groups and registrars as the facade.
- Config files published before 2.3.0 no longer fatal on the missing `commands_filenames`/`channels_filenames` keys; all config lookups now fall back to the shipped defaults.
- The module listener class-name resolver installs at register time, so runtime event discovery uses it (it previously ran before the resolver existed).

### Changes

- `modules:cache` and `modules:clear` exit cleanly with an info message when every asset type is disabled instead of throwing.
- `Feature::getName()` and `Feature::getViewName()` now delegate to `Modules::kebabName()` and `Modules::viewName()`, which are public API on the `Modules` service.

### Docs

- The caching guide now covers the `optimize` integration, recommends `php artisan event:cache` (module listeners are otherwise reflection-scanned on every request), and lists "after upgrading this package" as a cache rebuild trigger.

**Full Changelog**: [3.3.0...3.4.0](https://github.com/mozex/laravel-modules/compare/3.3.0...3.4.0)

## 3.3.0 - 2026-04-22

### What's new

**In-memory cache layer.** Scout discovery results now live in memory for the lifetime of the PHP process. The first access in a process discovers (or reads the `modules:cache` file if one exists); every access after that returns from memory. No effect on PHP-FPM or `php artisan serve`, which start a fresh process per request. Repeat scout access becomes free on Octane, Vapor, and long-running queue workers.

**Custom cache drivers via `BaseScout::useCacheDriverFactory()`.** You can now swap the default driver at runtime with a factory closure:

```php
use Mozex\Modules\Contracts\BaseScout;
use Spatie\StructureDiscoverer\Cache\DiscoverCacheDriver;

BaseScout::useCacheDriverFactory(
    fn (BaseScout $scout): DiscoverCacheDriver => new YourDriver($scout->cacheFile())
);


```
Any class implementing Spatie's `DiscoverCacheDriver` works. Pass `null` to restore the default. See the [caching docs](https://mozex.dev/docs/laravel-modules/v3/features/caching#custom-cache-drivers) for details.

**`Persistable` interface.** Drivers that need to separate runtime caching (`put()`) from explicit deploy-time persistence can implement `Mozex\Modules\Features\SupportCaching\Persistable`. When a driver implements it, `BaseScout::cache()` calls `persist()`; otherwise it falls back to `put()`. The default tiered driver uses this split so runtime cache warming stays in memory while `modules:cache` writes to disk.

### Changes

- Default driver is now `TieredDiscoverCacheDriver` (in-memory over file), installed by `RuntimeCache::install()` during package registration.
- `BaseScout::get()` auto-populates the cache driver on a discovery miss, so the in-memory layer warms up naturally on first read.
- `BaseScout::cache()` routes through `persist()` for drivers implementing `Persistable`, `put()` otherwise.

### Docs

- Added "Custom cache drivers" section to the caching guide and the Boost skill.

**Full Changelog**: [3.2.0...3.3.0](https://github.com/mozex/laravel-modules/compare/3.2.0...3.3.0)

## 3.2.0 - 2026-04-11

### What's changed

#### Fixes

- **Module name kebab-casing now handles acronyms correctly.** Names with consecutive uppercase letters no longer split into individual segments. `MyAPI` → `my-api` (was `my-a-p-i`), `HTMLParser` → `html-parser`, `IOStream` → `io-stream`. All-uppercase names (`PWA`, `CRM`) and standard PascalCase (`Blog`, `UserAdmin`) are unchanged. If you have a module with consecutive uppercase letters in its name, double-check your view, Blade component, Livewire, and translation references after upgrading.
  
- **`modules:list` reports real file counts for directory-based asset types.** Migrations, views, translations, listeners, Livewire components, and Filament assets were showing `1` per module. The command now counts files recursively inside each matched directory.
  

#### New

- **Laravel Boost skill.** Ships at `resources/boost/skills/laravel-modules/SKILL.md` and loads automatically on `php artisan boost:install`. Covers the full facade API, route customization, Livewire/Filament patterns, name guessing, Inertia (Vue and React), and testing setup. The existing Boost guideline has been rewritten to stay lean and focused.

#### Documentation

- Complete rewrite of every feature page and integration guide.
- New **Inertia** integration guide covering Vue and React: Vite alias with regex, Inertia page resolver for module-scoped pages, controller usage, TypeScript paths config, typed props via Spatie TypeScript Transformer (including the `script.globalTypeFiles` trick for Vue and the plain-TypeScript flow for React), and module CSS imports.
- Updated package descriptions in `composer.json` and `context7.json`.

**Full Changelog**: [3.1.0...3.2.0](https://github.com/mozex/laravel-modules/compare/3.1.0...3.2.0)

## 3.1.0 - 2026-03-31

* add modules:list command

**Full Changelog**: [3.0.4...3.1.0](https://github.com/mozex/laravel-modules/compare/3.0.4...3.1.0)

## 3.0.4 - 2026-03-30

### What's Changed

* Bump ramsey/composer-install from 3 to 4 by @dependabot[bot] in [#21](https://github.com/mozex/laravel-modules/pull/21)
* bump livewire dependency
* remove livewire workaround

**Full Changelog**: [3.0.3...3.0.4](https://github.com/mozex/laravel-modules/compare/3.0.3...3.0.4)

## 3.0.3 - 2026-03-08

* Fix Route::livewire() failing with class references for components registered via addNamespace()

**Full Changelog**: [3.0.2...3.0.3](https://github.com/mozex/laravel-modules/compare/3.0.2...3.0.3)

## 3.0.2 - 2026-03-08

* Fixed Route::livewire() not resolving module components when referenced by class (e.g., Teams::class) — workaround for
  [#10076](https://github.com/livewire/livewire/pull/10076)

**Full Changelog**: [3.0.1...3.0.2](https://github.com/mozex/laravel-modules/compare/3.0.1...3.0.2)

## 3.0.1 - 2026-02-26

* Update composer.json

**Full Changelog**: [3.0.0...3.0.1](https://github.com/mozex/laravel-modules/compare/3.0.0...3.0.1)

## 3.0.0 - 2026-02-25

### Laravel Modules v3.0.0

A major release that brings full Livewire v4 and Filament v5 support, adds Single-File and Multi-File Component discovery, and modernizes the platform requirements.

#### Highlights

##### Full Livewire v4 Component Support

All three Livewire v4 component types are now auto-discovered from your modules:

- **Class-based** components (as before)
- **Single-File Components (SFC)** — PHP and Blade in one `.blade.php` file
- **Multi-File Components (MFC)** — a named directory with `{name}.php` and `{name}.blade.php`

Place SFCs and MFCs in your module's `Resources/views/livewire/` directory and they're automatically registered under the module namespace:

```blade
<livewire:blog::counter />  {{-- SFC --}}
<livewire:blog::toggle />   {{-- MFC --}}


```
##### Namespace-Based Registration

Livewire component registration now uses `Livewire::addNamespace()`, aligning with Livewire v4's recommended approach for packages. This replaces the previous per-class `Livewire::component()` registration, resulting in cleaner integration and native support for all component types.

##### Filament v5 Support

Full compatibility with Filament v5. Module-based Resources, Pages, Widgets, and Clusters continue to be auto-discovered per panel.

#### Breaking Changes

- **PHP 8.3+ required** (dropped PHP 8.2)
- **Laravel 11.29+ required** (dropped Laravel 10)
- **Livewire v4 required** (dropped v3) — Composer will prevent installation with Livewire <4.0
- **Filament v5 required** (dropped v3/v4) — Composer will prevent installation with Filament <5.0
- **`LivewireComponentsScout`** changed from `ModuleClassScout` to `ModuleDirectoryScout` — scout output is now directory-based instead of class-based
- **Removed `SupportSchedules` feature** and `Mozex\Modules\Contracts\ConsoleKernel` — use `Routes/console.php` with the `Schedule` facade instead

#### New Configuration

Add `view_path` to the `livewire-components` section if you've published the config:

```php
'livewire-components' => [
    'active' => true,
    'patterns' => [
        '*/Livewire',
    ],
    'view_path' => 'Resources/views/livewire', // New in v3
],


```
#### Upgrading

See [UPGRADE.md](https://github.com/mozex/laravel-modules/blob/main/UPGRADE.md) for the full step-by-step upgrade guide.

If your application is not ready to upgrade to Livewire v4 or Filament v5, continue using the [2.x branch](https://mozex.dev/docs/laravel-modules/v2) which supports PHP 8.2, Laravel 10/11/12, Livewire v3, and Filament v3/v4.

**Full Changelog**: [2.8.0...3.0.0](https://github.com/mozex/laravel-modules/compare/2.8.0...3.0.0)

## 2.8.0 - 2026-02-07

### What's Changed

* Refine docs for precision and rewrite AI guidelines for minimal token usage by @mozex in [#18](https://github.com/mozex/laravel-modules/pull/18)
* Optimize performance with scout memoization and caching by @mozex in [#19](https://github.com/mozex/laravel-modules/pull/19)

**Full Changelog**: [2.7.2...2.8.0](https://github.com/mozex/laravel-modules/compare/2.7.2...2.8.0)

## 2.7.2 - 2026-01-24

### What's Changed

* Bump actions/cache from 4 to 5 by @dependabot[bot] in [#17](https://github.com/mozex/laravel-modules/pull/17)
* Bump actions/checkout from 5 to 6 by @dependabot[bot] in [#16](https://github.com/mozex/laravel-modules/pull/16)
* improve docs

**Full Changelog**: [2.7.1...2.7.2](https://github.com/mozex/laravel-modules/compare/2.7.1...2.7.2)

## 2.7.1 - 2025-11-06

* Fix AI guidelines rendering

**Full Changelog**: [2.7.0...2.7.1](https://github.com/mozex/laravel-modules/compare/2.7.0...2.7.1)

## 2.7.0 - 2025-11-06

**Full Changelog**: [2.6.3...2.7.0](https://github.com/mozex/laravel-modules/compare/2.6.3...2.7.0)

### What's Changed

* Bump stefanzweifel/git-auto-commit-action from 6 to 7 by @dependabot[bot] in [#15](https://github.com/mozex/laravel-modules/pull/15)
* Bump actions/checkout from 4 to 5 by @dependabot[bot] in [#14](https://github.com/mozex/laravel-modules/pull/14)
* Bump aglipanci/laravel-pint-action from 2.5 to 2.6 by @dependabot[bot] in [#13](https://github.com/mozex/laravel-modules/pull/13)
* Complete documentation
* Add Laravel Boost support

**Full Changelog**: [2.6.3...2.7.0](https://github.com/mozex/laravel-modules/compare/2.6.3...2.7.0)

## 2.6.3 - 2025-10-08

* fix event service provider

**Full Changelog**: [2.6.2...2.6.3](https://github.com/mozex/laravel-modules/compare/2.6.2...2.6.3)

## 2.6.2 - 2025-09-23

* require amphp/parallel

**Full Changelog**: [2.6.1...2.6.2](https://github.com/mozex/laravel-modules/compare/2.6.1...2.6.2)

## 2.6.1 - 2025-07-10

### What's Changed

* Bump stefanzweifel/git-auto-commit-action from 5 to 6 by @dependabot in [#12](https://github.com/mozex/laravel-modules/pull/12)
* Make type coverage compact
* Make config loading priority
* Fix deprecated reflection values

**Full Changelog**: [2.6.0...2.6.1](https://github.com/mozex/laravel-modules/compare/2.6.0...2.6.1)

## 2.6.0 - 2025-02-25

### What's Changed

* Add Laravel 12 compatibility by @mozex in [#11](https://github.com/mozex/laravel-modules/pull/11)

**Full Changelog**: [2.5.2...2.6.0](https://github.com/mozex/laravel-modules/compare/2.5.2...2.6.0)

## 2.5.2 - 2025-02-22

* fix guess model name for factories caused by laravel/framework#54644

**Full Changelog**: [2.5.1...2.5.2](https://github.com/mozex/laravel-modules/compare/2.5.1...2.5.2)

## 2.5.1 - 2025-02-10

### What's Changed

* Add registerRoutesUsing to route groups
* Bump dependabot/fetch-metadata from 2.2.0 to 2.3.0 by @dependabot in [#9](https://github.com/mozex/laravel-modules/pull/9)
* Bump aglipanci/laravel-pint-action from 2.4 to 2.5 by @dependabot in [#10](https://github.com/mozex/laravel-modules/pull/10)

**Full Changelog**: [2.5.0...2.5.1](https://github.com/mozex/laravel-modules/compare/2.5.0...2.5.1)

## 2.5.0 - 2025-01-11

### What's Changed

* Improve the structure of the package
* improve class discovering

**Full Changelog**: [2.4.3...2.5.0](https://github.com/mozex/laravel-modules/compare/2.4.3...2.5.0)

## 2.4.3 - 2024-05-17

* fix naming components

**Full Changelog**: [2.4.2...2.4.3](https://github.com/mozex/laravel-modules/compare/2.4.2...2.4.3)

## 2.4.2 - 2024-05-05

### What's Changed

* Bump dependabot/fetch-metadata from 2.0.0 to 2.1.0 by @dependabot in [#7](https://github.com/mozex/laravel-modules/pull/7)
* fix booting commands outside the console

**Full Changelog**: [2.4.1...2.4.2](https://github.com/mozex/laravel-modules/compare/2.4.1...2.4.2)

## 2.4.1 - 2024-04-19

* fix registering broadcast auth route

**Full Changelog**: [2.4.0...2.4.1](https://github.com/mozex/laravel-modules/compare/2.4.0...2.4.1)

## 2.4.0 - 2024-04-19

### What's Changed

* Bump aglipanci/laravel-pint-action from 2.3.1 to 2.4 by @dependabot in [#6](https://github.com/mozex/laravel-modules/pull/6)
* add support for channels.php files in the routes directory

**Full Changelog**: [2.3.1...2.4.0](https://github.com/mozex/laravel-modules/compare/2.3.1...2.4.0)

## 2.3.1 - 2024-04-11

### What's Changed

* Fix loading commands from the console.php file when routes are cached
* Bump dependabot/fetch-metadata from 1.6.0 to 2.0.0 by @dependabot in [#5](https://github.com/mozex/laravel-modules/pull/5)

**Full Changelog**: [2.3.0...2.3.1](https://github.com/mozex/laravel-modules/compare/2.3.0...2.3.1)

## 2.3.0 - 2024-03-14

* Add Laravel 11 commands file support

**Full Changelog**: [2.2.4...2.3.0](https://github.com/mozex/laravel-modules/compare/2.2.4...2.3.0)

## 2.2.4 - 2024-03-03

* fix translations prefix and directory

**Full Changelog**: [2.2.3...2.2.4](https://github.com/mozex/laravel-modules/compare/2.2.3...2.2.4)

## 2.2.3 - 2024-03-01

* fix livewire naming

**Full Changelog**: [2.2.2...2.2.3](https://github.com/mozex/laravel-modules/compare/2.2.2...2.2.3)

## 2.2.2 - 2024-03-01

* fix views naming

**Full Changelog**: [2.2.1...2.2.2](https://github.com/mozex/laravel-modules/compare/2.2.1...2.2.2)

## 2.2.1 - 2024-02-29

* fix filament problem with livewire component registration

**Full Changelog**: [2.2.0...2.2.1](https://github.com/mozex/laravel-modules/compare/2.2.0...2.2.1)

## 2.2.0 - 2024-02-29

* add support for filament (resources, pages, widgets, clusters)

**Full Changelog**: [2.1.0...2.2.0](https://github.com/mozex/laravel-modules/compare/2.1.0...2.2.0)

## 2.1.0 - 2024-02-28

* add support for defining route groups

**Full Changelog**: [2.0.1...2.1.0](https://github.com/mozex/laravel-modules/compare/2.0.1...2.1.0)

## 2.0.1 - 2024-02-28

* add "as" for routes

**Full Changelog**: [2.0.0...2.0.1](https://github.com/mozex/laravel-modules/compare/2.0.0...2.0.1)

## 2.0.0 - 2024-02-28

### What's Changed

* refactoring
* add caching support
* add support for Model name guessing
* improve Scheduling
* add support for Blade Components
* fix livewire naming
* improve routes
* improve factories
* improve policies
* improve views
* improve configs
* add tests
* add support for Laravel 11
* add support for listeners

**Full Changelog**: [1.3.0...2.0.0](https://github.com/mozex/laravel-modules/compare/1.3.0...2.0.0)

## 1.3.0 - 2023-11-22

- Support Service Providers

## 1.2.1 - 2023-11-16

- Fix schedule loading

## 1.2.0 - 2023-11-15

- Support Schedules

## 1.1.0 - 2023-11-13

- Add support for Policies

## 1.0.0 - 2023-10-15

Initial Release

---

## Table of Contents

- [Introduction](https://mozex.dev/docs/laravel-modules/v3)
- [AI Integration](https://mozex.dev/docs/laravel-modules/v3/ai-integration)
- [Support Us](https://mozex.dev/docs/laravel-modules/v3/support-us)
- [Requirements](https://mozex.dev/docs/laravel-modules/v3/requirements)
- [Changelog](https://mozex.dev/docs/laravel-modules/v3/changelog)
- [Contributing](https://mozex.dev/docs/laravel-modules/v3/contributing)
- [Questions & Issues](https://mozex.dev/docs/laravel-modules/v3/questions-and-issues)
- [About Mozex](https://mozex.dev/docs/laravel-modules/v3/about)

### Features

- [Blade Components](https://mozex.dev/docs/laravel-modules/v3/features/blade-components)
- [Views](https://mozex.dev/docs/laravel-modules/v3/features/views)
- [Routes](https://mozex.dev/docs/laravel-modules/v3/features/routes)
- [Configs](https://mozex.dev/docs/laravel-modules/v3/features/configs)
- [Migrations](https://mozex.dev/docs/laravel-modules/v3/features/migrations)
- [Seeders](https://mozex.dev/docs/laravel-modules/v3/features/seeders)
- [Commands](https://mozex.dev/docs/laravel-modules/v3/features/commands)
- [Helpers](https://mozex.dev/docs/laravel-modules/v3/features/helpers)
- [Models & Factories](https://mozex.dev/docs/laravel-modules/v3/features/models-factories)
- [Policies](https://mozex.dev/docs/laravel-modules/v3/features/policies)
- [Events & Listeners](https://mozex.dev/docs/laravel-modules/v3/features/events-listeners)
- [Service Providers](https://mozex.dev/docs/laravel-modules/v3/features/service-providers)
- [Translations](https://mozex.dev/docs/laravel-modules/v3/features/translations)
- [Caching](https://mozex.dev/docs/laravel-modules/v3/features/caching)
- [Listing Modules](https://mozex.dev/docs/laravel-modules/v3/features/listing)
- [Livewire Components](https://mozex.dev/docs/laravel-modules/v3/features/livewire-components)
- [Filament](https://mozex.dev/docs/laravel-modules/v3/features/filament)
- [Nova Resources](https://mozex.dev/docs/laravel-modules/v3/features/nova-resources)

### Integrations

- [PHPStan](https://mozex.dev/docs/laravel-modules/v3/integrations/phpstan)
- [PHPUnit](https://mozex.dev/docs/laravel-modules/v3/integrations/phpunit)
- [Pest](https://mozex.dev/docs/laravel-modules/v3/integrations/pest)
- [Inertia](https://mozex.dev/docs/laravel-modules/v3/integrations/inertia)