Filament Plugin Laravel Package

Product Decisions This Supports

• Unified Admin Dashboard: Integrate analytics directly into the Filament admin panel, reducing context-switching for teams managing both business operations and technical infrastructure. Eliminates the need for third-party tools like Google Analytics or Mixpanel, streamlining workflows for SaaS platforms, e-commerce, or subscription-based services.
• Data-Driven Decision Making: Enable real-time access to key metrics (visitors, revenue, registrations) for stakeholders without requiring SQL queries or manual exports. Supports roadmap items like "improve user retention" or "optimize marketing spend" by surfacing actionable insights in the admin UI.
• Build vs. Buy: Buy—avoids reinventing analytics dashboards from scratch. The plugin is a low-code solution with pre-built widgets (e.g., revenue trends, top referrers), reducing dev effort by ~80% compared to custom Laravel/Chart.js implementations. Ideal for teams with limited backend resources but needing professional-grade analytics.
• Self-Hosted Analytics: Supports compliance-sensitive use cases (e.g., GDPR, HIPAA) by allowing integration with self-hosted SimpleStats instances. Aligns with roadmap items like "expand EU market" or "add HIPAA-compliant features."
• Performance Monitoring: Track KPIs like ARPU (Average Revenue Per User) and ARPV (Average Revenue Per Visit) directly in the admin panel, critical for subscription-based businesses or membership platforms.
• Multi-Tenant SaaS: The plugin’s drilldown filter support (v1.2.3) enables tenant-specific analytics, addressing roadmap needs like "add tenant isolation" or "improve white-labeling."

When to Consider This Package

• Avoid if:
  • You need custom event tracking beyond SimpleStats’ native metrics (e.g., tracking non-standard user actions). The plugin is a passive consumer of SimpleStats data, not a tracking layer.
  • Your team requires advanced segmentation (e.g., funnel analysis, cohort tracking). SimpleStats’ free tier may lack depth for complex use cases; consider tools like PostHog or Amplitude.
  • You’re using Filament v4 or older or Laravel <12. The plugin is tightly coupled to Filament v5+.
  • You need real-time analytics (e.g., live dashboards). The plugin caches data (default: 60s TTL) for performance.
  • Your analytics are highly visual (e.g., heatmaps, session recordings). SimpleStats focuses on KPIs, not qualitative data.
• Consider alternatives if:
  • You’re already invested in Google Analytics or Matomo: Use their official Filament plugins instead.
  • You need open-source flexibility: Self-hosting SimpleStats adds complexity; alternatives like Laravel Analytics may offer more control.
  • Your team lacks Filament expertise: The plugin assumes familiarity with Filament’s plugin system and Livewire.

How to Pitch It (Stakeholders)

For Executives:

"This plugin embeds SimpleStats analytics directly into our Filament admin panel, giving our team instant visibility into visitor trends, revenue, and registrations—without leaving the dashboard. For example, our growth team can now track ARPU (Average Revenue Per User) in real time to optimize pricing or marketing spend. It’s a 10-minute setup that replaces manual reports, saving ~5 hours/week. For compliance-sensitive markets (e.g., EU), we can self-host SimpleStats to meet GDPR requirements. The cost? Just the SimpleStats subscription—no dev overhead."

Key Outcomes: ✅ Faster decisions: Metrics at your fingertips. ✅ Reduced tool fatigue: No more context-switching to third-party dashboards. ✅ Scalable: Works for single-tenant or multi-tenant SaaS.

For Engineering:

*"This is a drop-in Filament plugin that integrates SimpleStats.io analytics into our admin panel with minimal effort. Here’s why it’s a win:

• Zero custom dev work: Pre-built widgets for visitors, revenue, top referrers, etc. (7 widgets total).
• Performance-optimized: Caches API responses (configurable TTL) to avoid rate limits.
• Self-hosting support: Point to your own SimpleStats instance if needed.
• Lightweight: MIT-licensed, ~500 LOC, and actively maintained (last release: 2026).

Implementation:

1. Install via Composer: composer require simplestats-io/filament-plugin.
2. Add to PanelProvider: ->plugin(SimplestatsPlugin::make()).
3. Configure API token in .env.
4. Done—analytics appear at /admin/simplestats.

Trade-offs:

• Limited to SimpleStats’ metrics (no custom events).
• Caching may delay real-time updates (default: 60s).

Alternatives considered:

• Custom Laravel/Chart.js dashboard: 2–4 weeks of dev time.
• Third-party plugins: None offer this tight Filament integration.

Recommendation: Proceed—this is a high-leverage, low-risk addition for analytics visibility."*