v1.2.0

[mortalkiller]

v1.2.0 — Smoother Table Updates & Our First Community Contribution! 🎉

🎉 A huge welcome to our first community contributor!

This release marks a special milestone for Filament Skeleton Loading: our first community-contributed feature! 🥳

A massive thank you to "@goncalosoaresdev" (https://github.com/goncalosoaresdev) (Gonçalo Soares) for building "showSkeletonsOnTableUpdate()", adding documentation and browser tests, and following through on the Filament 4 compatibility fix. 🙌

Your contribution makes table interactions feel smoother for everyone using this package. Welcome to the contributor family, Gonçalo! 🚀👏

✨ What's new

Skeleton rows while tables update — opt-in

Enable skeleton rows whenever an already-loaded Filament table updates, including pagination, searching, filtering, sorting, switching tabs, grouping, and changing the number of records per page.

SkeletonLoadingPlugin::make()
->showSkeletonsOnTableUpdate();

You can also enable it selectively, per table:

SkeletonLoadingPlugin::make()
->showSkeletonsOnTableUpdate(fn (Table $table): bool => $table->getLivewire() instanceof ListRecords);

Or configure it for panels that register the plugin using:

SKELETON_LOADING_SHOW_ON_TABLE_UPDATE=true

Off by default. This option is independent of "deferTables()", preserves the initial loading behavior, and does not alter widgets, sections, or panels without the plugin.

🎨 Filament 4 and 5 styling

• Loading skeleton colors now work in both Filament 4 and Filament 5, using the appropriate native CSS variables.
• Existing panel radius, dark mode, and shimmer preferences continue to apply.
• Added a dedicated Workbench Invoices page and browser coverage for table updates, first-load behavior, and light/dark styling.

🔧 Maintenance

• Updated the "zizmor" GitHub Actions dependency.
• Expanded the README and documentation for configuration and table loading states.

✅ Verification

All five GitHub Actions workflows passed, including package tests, code quality, documentation, package standard, and browser tests.

⬆️ Upgrading

composer update mortalkiller/filament-skeleton-loading
php artisan filament:assets

The new table-update skeletons are optional: enable them explicitly in your panel or environment if you want them.

Compatibility: PHP 8.3+, Laravel 12/13, Filament 4.15.2+ or 5.10.2+.

Pull request: "#6 — showSkeletonsOnTableUpdate()" (#6)

Full changelog: v1.1.1...v1.2.0

---

Thanks again, Gonçalo — here's to many more community contributions! 🎊

---

This discussion was created from the release v1.2.0 .