Starter Kit Easy Laravel Package

Product Decisions This Supports

• Admin UX reliability for Filament-based products. The dock shortcut button no longer drifts off-screen on desktop after resize or Livewire polling, removing a visible “appears then disappears” defect in the admin shell.
• Build vs. buy for admin tooling. The kit continues to absorb upstream Filament plugin fixes (dock, Sentinel, model caching) so product teams can ship admin surfaces without owning each plugin’s internals.
• Adoption of the kit as a curated bundle. Sentinel 1.3.0 improves 403 messaging when a user has page permission but is blocked elsewhere, which supports clearer authorization troubleshooting and reduces support load.
• Quality gates for downstream projects. The PSR-4 fixture cleanup removes 12 composer install --optimize-autoloader warnings, improving install hygiene and making CI output cleaner for teams evaluating or onboarding the package.
• Roadmap signal: vendored JS patch management. The dock fix is delivered as a kit-served copy of the upstream bundle rather than a pure upstream dependency bump. This supports near-term stability but creates a maintenance obligation to regenerate the copy after the upstream dock package updates.

When to Consider This Package

Consider this package when:

• You are building or maintaining Filament admin panels and want a curated kit of admin UX components, including the quick-action dock, Sentinel authorization pages, and model caching.
• You need the desktop dock positioning fix now and cannot wait for the upstream hoceineel/filament-quick-action-dock release to be adopted directly.
• You value low-friction patch releases: v0.51.2 requires no install or migration, and kit:update brings the corrected public/js/kit/quick-action-dock.js.
• You want cleaner Composer/PSR-4 behavior in projects that install the package with optimized autoloading.
• You can accept a vendored JavaScript copy and a process step: do not edit it; after composer update of the dock package, run the kit suite to detect a stale copy and regenerate it with the provided command.

Look elsewhere or wait when:

• You require no vendored/patched upstream assets in your dependency chain.
• You are not using Filament or the specific bundled plugins.
• You need the dock fix to come directly from the upstream package rather than through this kit’s served script.
• Your team cannot operationalize the post-composer update regeneration check for the patched dock bundle.

How to Pitch It (Stakeholders)

For executives: v0.51.2 is a low-risk patch release. It fixes a visible desktop bug where the shortcut dock button fell off-screen, improves authorization messaging through a Sentinel dependency bump, and cleans up installer warnings. There is nothing to install or migrate, so the primary decision is whether to schedule the routine update and absorb a small process step around the vendored dock script.

For engineering: The dock fix replaces window.innerHeight with clientHeight in the kit-served public/js/kit/quick-action-dock.js via DockDeAtalhos::servirScriptCorrigido(). Do not edit that file. After updating the upstream dock package with Composer, run the kit suite; it will flag a stale copy and provide the regeneration command. The release also fixes 12 PSR-4 warnings from test fixtures (#170) and bumps Sentinel to 1.3.0, model caching to 13.2.0, and Playwright to 1.64.1.

For product: This protects admin usability and trust in the admin shell, especially on desktop Chrome where the dock previously mispositioned after resize or Livewire polling. It also makes 403 pages more informative when permission exists but access is blocked elsewhere, which should reduce confused support tickets.