- How do I install filament-dashboard-widgets in a Laravel Filament app?
- Install it with Composer using composer require laboiteacode/filament-dashboard-widgets. The package is designed to work out of the box and does not require migrations, queue workers, or external services. After installation, register the widgets on your Filament panel dashboard or use your panel's widget discovery setup.
- Which Laravel and Filament versions does filament-dashboard-widgets support?
- The documented requirements are PHP 8.3, 8.4, or 8.5, Laravel 12 or 13, and Filament 4.12+ or 5.7.1+. Check the Composer constraints before upgrading Filament, because Filament major releases can introduce breaking changes. Pin versions in production and review the changelog when bumping either Laravel or Filament.
- Does filament-dashboard-widgets require npm or a front-end build step?
- No. The package explicitly ships with no front-end build step and no additional front-end dependencies. It injects a small self-contained stylesheet inline using Filament design tokens and the panel accent colour. That makes it suitable for teams that want dashboard widgets without adding a JavaScript or Tailwind build pipeline.
- What dashboard widgets are included in this Filament package?
- It includes fifteen widgets: metric, goal progress, breakdown, trend, recent items, composition, detail list, bullet, funnel, timeline, variance, segment bar, usage limits, comparison chart, and a flexible customizable card. All widgets share a consistent, typed API built around fluent data objects. The package is aimed at SaaS dashboards, CRMs, back-offices, and internal business tools.
- How do I pass data to Filament dashboard widgets from Eloquent or arrays?
- Widgets accept static data or computed data, and closures are evaluated at render time. Data is expressed through the package's typed, immutable-friendly data objects rather than bespoke Blade partials. The package does not run queries itself, so you control whether data comes from an Eloquent query, a cached aggregate, or a precomputed array.
- Does filament-dashboard-widgets support dark mode, custom themes, and responsive dashboards?
- Yes, the widgets support light and dark themes, responsive layouts, and accessible markup out of the box. They use native Filament components for empty states, badges, icons, links, and actions, so they follow your panel's styling. Styling is injected inline with Filament design tokens, but you should still validate heavily customized panels and custom accent colours visually.
- Does the package run database queries or require migrations?
- No. The README states that no query is ever run by the package and that output is escaped by default. There are no migrations, seeders, queue workers, or external services involved. You supply the data through arrays or closures, which keeps query count and multi-tenant scoping under your application's control.
- How do I test Filament dashboard widgets in my Laravel application?
- The package has a GitHub Actions test workflow, so you can check its CI signal before adopting it. In your app, mount each widget in a Filament or Livewire test with fixture data and assert the rendered labels, values, and empty states. Add snapshot or HTML assertions for any widgets you customize, especially before major Filament upgrades.
- Can I customize a dashboard widget without forking the package?
- Start with the flexible customizable card widget and the fluent typed API, which are intended for adapting widget content and presentation. For deeper changes, inspect the package docs for publishable views or configuration and for class extension points before overriding behavior. If a required change is not exposed as an extension point, fork or wrap the widget deliberately and track upstream changes.
- What are the alternatives to filament-dashboard-widgets for Filament dashboards?
- The main alternative is building your own widgets with Filament's native Widget and ChartWidget classes, which gives maximum control but repeats common KPI, goal, trend, and timeline work. Other Filament dashboard widget packages may cover similar ground, and dedicated analytics or charting tools are better for deep visualization. This package fits teams already using Filament for SaaS, CRM, or back-office dashboards who want polished widgets quickly.