Filament Date Scopes Filter Laravel Package

Product Decisions This Supports

• Enhancing Data Exploration in Admin Panels: Accelerate development of Filament-based admin dashboards by enabling granular date-based filtering (seconds to millennia) without custom UI/UX work. Reduces frontend/backend coupling for time-based queries.
• Roadmap for Analytics Features: Justify investment in time-series data tools by providing a low-code foundation for filtering historical records (e.g., "Show orders from Q2 2023").
• Build vs. Buy Decision: Avoid reinventing date-range UIs for Filament tables. Leverages existing laravel-date-scopes for backend consistency while adding a polished frontend layer.
• Use Cases:
  • Audit logs with timestamp precision (e.g., "Last 5 minutes").
  • Financial reports by fiscal quarters/years.
  • Customer support tickets by week/month.
  • Inventory tracking by day/decade for trend analysis.

When to Consider This Package

• Adopt if:

  • Your Filament admin panel requires multi-granularity date filtering (beyond basic "last 7 days").
  • Teams prioritize developer velocity over custom UI components.
  • You’re using Filament v3–v5 and Laravel 8.1+ (PHP 8.1–8.5).
  • Models already support laravel-date-scopes (or you’re willing to add them).
  • Localization (e.g., Arabic) is needed for date labels.

• Look elsewhere if:

  • You need custom date-range pickers (e.g., "Between X and Y").
  • Your app uses non-Filament admin panels (e.g., Livewire, Inertia).
  • You require real-time filtering (this is for query-based tables).
  • Your date logic is highly bespoke (e.g., business-specific fiscal calendars).
  • You’re on Laravel <8.1 or PHP <8.1.

How to Pitch It (Stakeholders)

For Executives: "This package lets our admin users filter data by time—from seconds to millennia—with a few lines of code. It’s like giving them a time-machine slider for our Filament dashboards, reducing the dev effort to build custom date filters by 80%. For example, support teams can instantly see tickets from ‘last 30 minutes,’ while finance can drill into quarterly trends without writing UI code. It’s a low-risk, high-reward way to supercharge data exploration."

For Engineers: *"This is a drop-in Filament filter that wraps laravel-date-scopes to add a polished UI for time-based queries. Key benefits:

• Zero frontend work: Just add DateScopeFilter::make('created_at') to your table.
• Backend consistency: Uses the same date-scope logic as your models.
• Flexible: Exclude granularities (e.g., ->withoutHours()) or localize labels.
• Future-proof: Supports Filament v5 and PHP 8.5. Tradeoff: Requires laravel-date-scopes on models, but the payoff is a reusable, maintainable filter that saves hours of dev time."*