Laravel Dashboard Laravel Package

Summary

Version 4 modernizes laravel-dashboard with updated dependencies, proper PHP enums, and improved developer tooling.

Breaking changes

• Livewire 4 required (drops Livewire 3 support)
• Laravel 11+ required (drops Laravel 10 support)
• Tailwind CSS 4 — upgraded from v1, using new [@theme](https://github.com/theme) directive and [@tailwindcss](https://github.com/tailwindcss)/browser CDN for the default view
• Dashboard::getTheme() now returns Theme enum, Dashboard::getMode() returns Mode enum (instead of strings)
• Tile model uses $fillable instead of $guarded = [], and casts() method instead of $casts property
• DashboardTileComponent::$refreshIntervalInSeconds renamed to $refreshInterval
• Fluent methods return static instead of self
• Migration stub uses anonymous class

New features

• BaseTileComponent — abstract Livewire component with #[Defer] attribute and a skeleton placeholder, giving tiles lazy-loading out of the box
• Theme and Mode enums — type-safe theme/mode handling replacing string constants
• lazy and defer props on <x-dashboard-tile> component
• PHPStan level 8 with Larastan

Improvements

• Migrated test suite from PHPUnit to Pest
• Expanded test coverage: new tests for DashboardComponent, UpdateModeComponent, theme query parameters, tile edge cases
• CI matrix now includes PHP 8.5
• Removed inline CSS injection from service provider (CSS now loaded via Tailwind browser CDN in view)
• Removed unused $defaultTheme contextual binding from service provider
• Constructor property promotion across components
• Typed return types on all methods
• Removed yarn.lock / husky / lint-staged, switched to npm with modern dependency versions

Upgrade guide

See UPGRADE.md for detailed migration instructions.

New Contributors

• @timvandijck made their first contribution in https://github.com/spatie/laravel-dashboard/pull/128

Full Changelog: https://github.com/spatie/laravel-dashboard/compare/3.3.1...4.0.0

Support Livewire 4

What's Changed

• Update links and embedded images to v3 by @rdanklof in https://github.com/spatie/laravel-dashboard/pull/122
• Update OhDear Laravel Package documentation link by @renoirtech in https://github.com/spatie/laravel-dashboard/pull/123
• Laravel 12.x Compatibility by @laravel-shift in https://github.com/spatie/laravel-dashboard/pull/124

New Contributors

• @rdanklof made their first contribution in https://github.com/spatie/laravel-dashboard/pull/122
• @renoirtech made their first contribution in https://github.com/spatie/laravel-dashboard/pull/123

Full Changelog: https://github.com/spatie/laravel-dashboard/compare/3.1.1...3.2.0

What's Changed

• Remove the packagist tile from the list because I have abandoned it. by @tvbeek in https://github.com/spatie/laravel-dashboard/pull/120
• Feature: Customise Page Title by @fredbradley in https://github.com/spatie/laravel-dashboard/pull/121

New Contributors

• @fredbradley made their first contribution in https://github.com/spatie/laravel-dashboard/pull/121

Full Changelog: https://github.com/spatie/laravel-dashboard/compare/3.1.0...3.1.1

What's Changed

• Update upgrading.md by @remievraere in https://github.com/spatie/laravel-dashboard/pull/114
• Laravel 11.x Compatibility by @laravel-shift in https://github.com/spatie/laravel-dashboard/pull/115

New Contributors

• @remievraere made their first contribution in https://github.com/spatie/laravel-dashboard/pull/114

Full Changelog: https://github.com/spatie/laravel-dashboard/compare/3.0.2...3.1.0

• Reload page on session expiration

Full Changelog: https://github.com/spatie/laravel-dashboard/compare/3.0.1...3.0.2

• Fix for Livewire 3

• Update for Livewire 3

What's Changed

• Update overview.md by @WouterBrouwers in https://github.com/spatie/laravel-dashboard/pull/100
• Add livewire hook to refresh page on 419 error. by @dbohn in https://github.com/spatie/laravel-dashboard/pull/105
• Fix Tests Shield Badge by @faissaloux in https://github.com/spatie/laravel-dashboard/pull/107
• Replace php_cs with Pint by @faissaloux in https://github.com/spatie/laravel-dashboard/pull/109
• Fix Pint workflow by @faissaloux in https://github.com/spatie/laravel-dashboard/pull/110
• Laravel 10.x Compatibility by @laravel-shift in https://github.com/spatie/laravel-dashboard/pull/111

New Contributors

• @WouterBrouwers made their first contribution in https://github.com/spatie/laravel-dashboard/pull/100
• @dbohn made their first contribution in https://github.com/spatie/laravel-dashboard/pull/105
• @faissaloux made their first contribution in https://github.com/spatie/laravel-dashboard/pull/107
• @laravel-shift made their first contribution in https://github.com/spatie/laravel-dashboard/pull/111

Full Changelog: https://github.com/spatie/laravel-dashboard/compare/2.1.3...2.1.4

What's Changed

• Fix attribute class by @mbardelmeijer in https://github.com/spatie/laravel-dashboard/pull/93

New Contributors

• @mbardelmeijer made their first contribution in https://github.com/spatie/laravel-dashboard/pull/93

Full Changelog: https://github.com/spatie/laravel-dashboard/compare/2.1.2...2.1.3

What's Changed

• Fix link to video (v2 docs) by @felixfrey in https://github.com/spatie/laravel-dashboard/pull/92
• Update tile.blade.php by @aymanatmeh in https://github.com/spatie/laravel-dashboard/pull/88

New Contributors

• @aymanatmeh made their first contribution in https://github.com/spatie/laravel-dashboard/pull/88

Full Changelog: https://github.com/spatie/laravel-dashboard/compare/2.1.1...2.1.2

What's Changed

• Ability to not load external dependencies by @billmn in https://github.com/spatie/laravel-dashboard/pull/90

New Contributors

• @billmn made their first contribution in https://github.com/spatie/laravel-dashboard/pull/90

Full Changelog: https://github.com/spatie/laravel-dashboard/compare/2.1.0...2.1.1

What's Changed

• Trello tile added. by @tkaratug in https://github.com/spatie/laravel-dashboard/pull/66
• Update twitter-tile.md by @tvbeek in https://github.com/spatie/laravel-dashboard/pull/67
• Small typo fix by @JosephSilber in https://github.com/spatie/laravel-dashboard/pull/68
• Helpscout tile added by @Dion213 in https://github.com/spatie/laravel-dashboard/pull/69
• Laravel news tile by @dietercoopman in https://github.com/spatie/laravel-dashboard/pull/83
• Allow Laravel 9 by @tvbeek in https://github.com/spatie/laravel-dashboard/pull/87

New Contributors

• @tkaratug made their first contribution in https://github.com/spatie/laravel-dashboard/pull/66
• @JosephSilber made their first contribution in https://github.com/spatie/laravel-dashboard/pull/68
• @Dion213 made their first contribution in https://github.com/spatie/laravel-dashboard/pull/69
• @dietercoopman made their first contribution in https://github.com/spatie/laravel-dashboard/pull/83

Full Changelog: https://github.com/spatie/laravel-dashboard/compare/2.0.1...2.1.0

• allow PHP 8

• add support for Livewire 2
• drop support for Laravel 7

• add support for Laravel 8

• allow to override the external dependencies (#41)

• Add --color-success CSS variable

• add stacks for assets and scripts on render tile (#16)

• initial release