Livewire Tables Laravel Package

Getting Started

Start by installing the package via Composer (composer require lunarphp/livewire-tables), then publish its config and stubs using php artisan vendor:publish --tag=livewire-tables-config. Create your first table class by extending LunarPHP\LivewireTables\Table, define columns in the columns() method (e.g., Column::make('Name', 'name')), and attach the @livewire('table') directive in a Blade view. For quick wins, scaffold a table for an existing model (e.g., User) using php artisan make:table UserTable, then wire it up by returning a query (e.g., User::query()) from the query() method.

Implementation Patterns

Use Column::text(), Column::boolean(), and Column::select() for common render types—cells can be customized via closures or custom view components. Leverage filter() to define reactive filters (text, select, date) and sort() to declare sortable columns; Livewire handles state and reactivity automatically. For bulk actions, implement bulkActions() to return an array of Action objects, each tied to a call method in the table class. To keep logic clean, separate concerns: columns() for UI, query() for data fetching, and actions()/bulkActions() for business logic. Keep state minimal—rely on Livewire’s built-in reactivity instead of storing large arrays.

Gotchas and Tips

• The package assumes column names match database fields unless aliased—use Column::make('Display', 'custom_column_name') for mismatches.
• Filtering on relationships requires explicit whereHas() logic in your query() method (e.g., $query->whereHas('role', fn($q) => $q->where('name', $value))).
• Pagination uses simplePaginate() under the hood; if you need full pagination (with total count), override usePagination().
• Custom filters must be registered with matching filter() method names and handled in applyFilters() if overriding default behavior.
• The last release is from 2022—verify compatibility with newer Livewire (v3) and Laravel versions before adoption; consider checking community forks or contributing fixes if maintenance is stale.