README

A powerful Laravel Livewire package that simplifies the creation of interactive, feature-rich data tables with minimal effort.

Overview

Livewire Simple Tables is designed to help Laravel developers quickly build beautiful, interactive data tables without the complexity often associated with table implementations. This package leverages Laravel Livewire to provide a reactive, real-time user experience.

Features

• Easy to Set Up: Get started with just a few lines of code
• Powerful Data Management: Built-in pagination, sorting, and searching
• Customizable Filters: Create dependent, reactive filters to narrow down data
• Interactive Actions: Add row-level actions and bulk operations
• Row Detail Views: Expand rows to show additional information
• Beautifully Styled: Built with Tailwind CSS for a clean, modern look
• Highly Extensible: Create custom themes, filters, and components

Installation

composer require tiagospem/simple-tables

For detailed installation instructions, see the Installation Guide.

Quick Start

Create a Table Component

php artisan st:create table UsersTable

Implement the Table Component

<?php

namespace App\Livewire;

use App\Models\User;
use Illuminate\Database\Eloquent\Builder;
use TiagoSpem\SimpleTables\Column;
use TiagoSpem\SimpleTables\SimpleTableComponent;

class UsersTable extends SimpleTableComponent
{
    public function columns(): array
    {
        return [
            Column::text('ID', 'id')->sortable(),
            Column::text('Name', 'name')->sortable()->searchable(),
            Column::text('Email', 'email')->searchable(),
            Column::text('Created At', 'created_at')->sortable(),
        ];
    }

    public function datasource(): Builder
    {
        return User::query();
    }
}

Add to Your Blade View

<div>
    <h1>Users</h1>
    
    <div class="mt-4">
        <livewire:users-table />
    </div>
</div>

Documentation

For comprehensive documentation, visit https://tiagospem.github.io/livewire-simple-tables/

• Installation
• Configuration
• Basic Usage
• Advanced Usage
• Components

Requirements

• PHP 8.3+
• Laravel 10+
• Livewire 3.5.4+
• Tailwind CSS v3

License

This package is open-sourced software licensed under the MIT license.