Filament Pan Analytics Widget Laravel Package

Product Decisions This Supports

• Admin analytics visibility: The package embeds Pan Analytics into Filament admin panels, giving product, ops, and support teams in-product analytics without a separate BI tool.
• Build vs. buy: For teams already on Filament 4/5, this is a low-cost, maintained widget instead of a custom analytics dashboard. It is not a replacement for a full BI platform, but it covers common operational reporting needs.
• Access-control roadmap: The new ->authorize(bool|Closure) plugin method supports role- or policy-based visibility, enabling tiered admin access and safer rollout to broader internal audiences.
• Platform modernization: 5.0.0 aligns with Filament 4/5, Laravel 12/13, PHP 8.3–8.5, and removes JavaScript build tooling. This supports roadmap decisions to reduce frontend build/deployment complexity.
• Upgrade sequencing: Filament 3 applications should remain on the 4.x branch. Product and engineering should plan the widget upgrade only alongside a Filament 4/5 migration.
• Data trust and support reduction: The new empty state explains where data comes from, reducing “why is this blank?” support requests. Right-aligned numeric columns improve scanability for dashboard users.
• Use cases: Internal admin dashboards, SaaS operations metrics, customer/support activity views, and lightweight product-usage reporting where Pan Analytics is already the data source.

When to Consider This Package

Consider adoption when:

• The application is on Filament 4 or 5, with Laravel 12/13 and PHP 8.3–8.5 as tested by the package.
• You need a drop-in Pan Analytics widget for Filament admin panels and want to avoid building and maintaining custom dashboard code.
• You need configurable widget visibility via ->authorize(bool|Closure).
• You value low operational overhead: 5.0.0 ships no assets and requires no JavaScript build pipeline.
• You want stronger code-quality signals: strict types, Larastan/PHPStan level max, and architecture tests.

Look elsewhere or defer when:

• The application is on Filament 3 — do not adopt 5.0.0; stay on the 4.x branch until the Filament upgrade is planned.
• You depend on removed 4.x surfaces: the facade, FilamentPanAnalyticsWidget class, testing mixin, stubs, view namespace, or install command.
• You rely on the old “all” page-size option or the getSearchable() method; these require migration changes.
• You need analytics beyond Pan Analytics, deep custom reporting, or a full BI/warehouse layer.
• You are not using Pan Analytics or do not run Filament admin panels.

How to Pitch It (Stakeholders)

For executives: This package puts analytics directly into the admin experience, reducing reliance on separate BI tools and custom dashboard work. The 5.0.0 release is primarily an alignment release for Filament 4/5 and Laravel 12/13. It adds access control, improves data clarity, and removes JavaScript build tooling — lowering maintenance and deployment overhead. If we are still on Filament 3, there is no immediate action; the 4.x branch remains the correct path until our Filament upgrade.

For engineering: 5.0.0 is a breaking release, but the changes are mostly cleanup and modernization. Migration checklist: rename FilamentPanAnalyticsWidgetPlugin::getSearchable() to isSearchable(), remove the “all” page-size option, update translation keys, and remove references to deleted facade/class/testing mixin/stubs/view namespace/install command. New authorize() and current() APIs improve access control and safe panel integration. The package now has strict types, max-level PHPStan/Larastan, architecture tests, and no asset pipeline. Recommend upgrading when the Filament 4/5 migration happens; otherwise stay on 4.x.