Skip to content

Install Inertia Table for Laravel + Vue 3

This guide walks through installing Inertia Table v4 in a Laravel application that uses Inertia.js with Vue 3. If you're using React instead, follow the React installation guide. For the side-by-side reference page, see Installation.

Inertia Table v4.x requires Tailwind CSS v4.x. For older versions, v3.x receives security fixes only and v2.x is no longer supported.

Composer Authentication

Installing Inertia Table requires a valid license. Your license key is available in the Inertia UI portal, where you may also purchase one.

Satis Repository

First, add the Inertia UI Composer repository to your composer.json file:

json
"repositories": [
    {
        "type": "composer",
        "url": "https://satis.inertiaui.com"
    }
]

Authentication

Inertia Table authenticates with the Satis repository via your email address and license key. Pick the option that matches where your app runs:

bash
composer config --global --auth http-basic.satis.inertiaui.com "your-email-address" "your-license-key"
json
{
    "http-basic": {
        "satis.inertiaui.com": {
            "username": "your-email-address",
            "password": "your-license-key"
        }
    }
}
bash
composer config http-basic.satis.inertiaui.com "your-email-address" "your-license-key"
text
Open your server in Forge, go to Composer Package Authentication,
and add satis.inertiaui.com as the repository URL with your email
and license key. No command needed.

Local stores the credentials in ~/.composer/auth.json on your machine. Use auth.json to commit the credentials alongside composer.json in a team project (do not commit them to a public repository). On Laravel Cloud, add the composer config command to your environment's build commands, before composer install. On Laravel Forge, add the credentials on the Composer Package Authentication screen of your server settings.

Install the Composer Package

Install Inertia Table via Composer:

bash
composer require inertiaui/table:^4.0

Install the Vue NPM Package

After installing the Composer package, link the Vue package into your project. This creates a symlink in your node_modules directory to the package in the vendor directory:

bash
npm install vendor/inertiaui/table/vue
bash
pnpm add file:vendor/inertiaui/table/vue

pnpm users

pnpm requires the file: protocol (pnpm add file:...) instead of a plain pnpm install. This ensures transitive dependencies like @inertiaui/vanilla are resolved correctly.

Tailwind CSS v4 Configuration

Inertia Table v4.x requires Tailwind CSS v4.1+. Use the @source directive in your CSS file to include the Inertia Table package paths:

css
@import 'tailwindcss';

@source '../../vendor/inertiaui/table/vue/src/**/*.{js,vue}';

For a custom dark mode strategy, see the Dark Mode Strategy documentation.

Action and Export Routes

Inertia Table requires two routes to execute actions and export data. The package registers a macro on the Route facade to make this easier. Add the following code to your web.php file:

php
Route::inertiaTable();

Next Steps

You're ready to build your first table. Continue with:

Last updated: