README

Server-driven filterable, sortable, paginated data tables for Inertia.js v3 + Vue 3, with bundled shadcn-vue UI primitives. Private package.

Features

Fluent PHP API with autocompletion (Table, Column, Filter, Action classes)
Built-in text / date / badge / boolean / image / action column types
Text / dropdown / boolean / date filters with a rich clause system (contains, between, is_set, etc.)
Sticky headers, sticky pagination, stickable columns, column resize + visibility
Multi-table per-page support with scope isolation
Artisan scaffolding: make:table, make:column, make:filter
Orchestra Workbench demo app with live Inertia+Vue stack

Requirements

PHP 8.4+
Laravel 13.x
Inertia.js v3 (inertiajs/inertia-laravel ^3.0)
Vue 3.5+
Tailwind CSS v4
Spatie Laravel Query Builder 7+ (spatie/laravel-query-builder ^7.2)
Pinia (client-side)

Installation

See docs/installation.md for the full guide.

Quick:

composer require alik-laravel/inertia-table
php artisan vendor:publish --tag=inertia-table-components
php artisan vendor:publish --tag=inertia-table-styles

Quick Start

// app/Tables/UsersTable.php
use Alik\InertiaTable\Table;
use Alik\InertiaTable\Columns\{TextColumn, DateColumn, BadgeColumn};
use Alik\InertiaTable\Filters\{TextFilter, DropdownFilter};
use Alik\InertiaTable\Enums\Variant;
use App\Models\User;
use Override;

final class UsersTable extends Table
{
    protected string $resource = User::class;

    #[Override]
    public function columns(): array
    {
        return [
            TextColumn::make('name')->sortable()->searchable(),
            BadgeColumn::make('status')->variant([
                'active' => Variant::Green,
                'pending' => Variant::Yellow,
                'suspended' => Variant::Red,
            ]),
            DateColumn::make('created_at')->format('Y, M d'),
        ];
    }

    #[Override]
    public function filters(): array
    {
        return [
            TextFilter::make('name'),
            DropdownFilter::make('status')->options([
                'active' => 'Active',
                'pending' => 'Pending',
                'suspended' => 'Suspended',
            ]),
        ];
    }
}

// Controller
return Inertia::render('Users/Index', [
    'users' => UsersTable::make()->withQuery(User::query()),
]);

<!-- Users/Index.vue -->
<script setup lang="ts">
import { Table, type Paginated } from '@/vendor/inertia-table/table';

defineProps<{ users: Paginated<any> }>();
</script>

<template>
  <Table name="users" :resource="users" />
</template>

The name prop on <Table> and the key in Inertia::render([...]) must be the same string. The package auto-binds the table's PHP-side name to that key, so ->as(...) is only needed when you want a name that differs from the Inertia prop key. See docs/installation.md.

Documentation

Installation — composer, Vite config, publishing assets
Columns — all column types with every option
Filters — all filter types + Clause enum reference
Actions — Action, Icon, Image configuration
Customization — overriding published Vue components, stubs, theme tokens
Testing — writing tests for tables and filters

Workbench

The package ships an Orchestra Workbench demo app. From the package directory:

composer install
npm install
npm run build                 # build Vite assets into workbench/public/build
composer run build            # migrate, seed, publish workbench assets
ln -sfn ../../../../../workbench/public/build vendor/orchestra/testbench-core/laravel/public/build
ln -sfn ../../../../../workbench/public/hot   vendor/orchestra/testbench-core/laravel/public/hot
composer run serve            # http://localhost:8000
npm run dev                   # hot reload Vite in another terminal

Why the symlinks?

Vite writes to workbench/public/, but Laravel's Vite facade resolves the manifest (and the hot file) via public_path(), which under Testbench points to vendor/orchestra/testbench-core/laravel/public/. Without the two symlinks above you get Illuminate\Foundation\ViteManifestNotFoundException on every request.

The vendor/ directory is rewritten by composer install / composer update, so re-run both ln -s commands (or the php -r snippets above) after every dependency install — or add them to a local script you run on fresh clones.

License

Proprietary. See LICENSE.md.

alik-laravel / inertia-table

Maintainers

Package info

Fund package maintenance!

Statistics

Security