- How do I install fidum/laravel-dashboard-chart-tile?
- Install it with Composer using composer require fidum/laravel-dashboard-chart-tile. You then register the tile in your spatie/laravel-dashboard dashboard class and publish the package assets. There is no migration, queue worker, or external service to configure; the main setup work is supplying chart data from your Livewire component.
- Does fidum/laravel-dashboard-chart-tile support Laravel 13?
- Version 6.3.0 is a compatibility release that claims Laravel 13.x support. That constraint only covers this tile, not spatie/laravel-dashboard or Livewire, so confirm the host dashboard package also supports Laravel 13 before upgrading. If you are on Laravel 11 or 12, 6.2.0 remains the appropriate pin unless you have verified the full stack.
- Which Livewire version do I need for this dashboard chart tile?
- The tile depends on Livewire through the spatie/laravel-dashboard stack, and the required Livewire major can change between tile releases. Check the composer.json constraints for the exact version you plan to install and match them to your application's Livewire version. Do not assume Laravel 13 support in the tile means your existing Livewire major is supported.
- How do I add a chart tile to a spatie/laravel-dashboard?
- Create or update a dashboard class that extends the spatie dashboard and register the chart tile alongside your other tiles. Supply the tile with a data payload, typically labels and datasets, from a Livewire component or dashboard class method. The tile is a presentation-layer component, so keep the querying and authorisation outside it and pass in a plain array or collection.
- What data format does the chart tile expect?
- The tile expects a chart data payload containing labels and datasets, similar to Chart.js configuration. Build that payload in your own Livewire component or dashboard code after fetching and authorising the data. Keep the shape in one place so you can adapt if the tile's contract changes across 6.x releases.
- Can I customize chart colors, labels, and chart type?
- Yes. The tile is designed to let you configure chart data, labels, colors, and display options before rendering. Those options are passed through the tile configuration rather than being hard-coded by the package. Check the published views and asset config for the exact option names in your installed version.
- Do I need to publish assets for the chart tile?
- Yes, the standard integration path includes publishing the package assets. The chart rendering depends on the published JavaScript and a Chart.js version, so stale assets are the most likely cause of silent breakage after an upgrade. Re-publish or verify assets whenever you change the tile version.
- How do I refresh or poll chart data in the tile?
- Refresh behaviour is not owned by the tile; it depends on how your Livewire component supplies data. You can refresh the tile by updating the data payload from the component, for example on a poll or an explicit refresh action. Decide the polling interval deliberately and keep expensive queries out of the render path.
- Is fidum/laravel-dashboard-chart-tile safe for production?
- It is a small, single-maintainer presentation package with a narrow surface area, which keeps risk low but means you should treat it as replaceable. The main production concerns are compatibility with the host dashboard package, published asset freshness, and authorisation of the data you pass in. Pin a version, capture composer.lock, and test upgrades against your Laravel, Livewire, and dashboard versions.
- Can I use this chart tile without spatie/laravel-dashboard?
- No, it is built as a tile for spatie/laravel-dashboard and is not a standalone charting library. If you do not already run that dashboard, this package is not a reason to adopt one. For a one-off chart, a hand-rolled Blade partial with Chart.js is likely a simpler and more replaceable option.