v2.2.0

[mortalkiller]

v2.2.0 — Artisan page header generator

Added

• Added the new make:filament-page-header Artisan command for setting up page headers on existing Filament Resources.
• Added interactive selection of the Resource pages that should use HasPageHeader.
• Added support for explicit non-interactive page selection with repeated --page options.
• Added --panel support for applications with multiple Filament panels.
• Added --no-pages to generate the conventional header schema without modifying Resource page classes.
• Added --force to deliberately replace an existing generated header schema.

Example:

php artisan make:filament-page-header OrderResource

Or explicitly:

php artisan make:filament-page-header OrderResource \
    --panel=admin \
    --page=list \
    --page=view \
    --page=edit

The generator creates the conventional Resource header schema and safely adds HasPageHeader to the selected standard Resource pages without duplicating imports or trait declarations.

Documentation

• Added dedicated documentation for custom page header record contexts through getPageHeaderRecord().
• Added examples for tenant-backed pages.
• Added examples for parent-record contexts.
• Added examples for settings and singleton models.
• Added examples for custom Filament pages backed by an Eloquent model.
• Added support documentation for array-backed header contexts.
• Documented Create-page behavior when no persisted record exists.
• Documented multi-panel usage and clarified that the plugin must be registered separately on each panel that should use custom headers.
• Clarified that changing the header record context does not change Resource persistence, page authorization, action authorization, or application access rules.
• Added dedicated generator documentation covering interactive usage, non-interactive usage, multi-panel applications, existing schemas, and supported Resource page types.
• Added a public project roadmap documenting the planned direction for developer experience, header navigation, and action controls.

Improved

• Existing header schemas are preserved by default when the generator is run again.
• Resource resolution supports short names, fully-qualified class names, and multi-panel applications.
• Repeated generator runs avoid duplicate HasPageHeader imports and trait declarations.

Testing

• Added regression coverage for generator behavior, repeated execution, schema protection, page selection, and invalid option combinations.
• Improved browser asset-loading tests so they also work correctly from branch names containing /.
• Validated the package across the supported Filament 4 and Filament 5 test matrix.

Upgrade notes

This release is backwards compatible with existing 2.x applications.

No application code or configuration changes are required when upgrading.

After updating the package, continue to publish Filament assets as usual:

php artisan filament:assets

---

This discussion was created from the release v2.2.0.