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:
"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:
composer config --global --auth http-basic.satis.inertiaui.com "your-email-address" "your-license-key"{
"http-basic": {
"satis.inertiaui.com": {
"username": "your-email-address",
"password": "your-license-key"
}
}
}composer config http-basic.satis.inertiaui.com "your-email-address" "your-license-key"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:
composer require inertiaui/table:^4.0Install 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:
npm install vendor/inertiaui/table/vuepnpm add file:vendor/inertiaui/table/vuepnpm 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:
@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:
Route::inertiaTable();Next Steps
You're ready to build your first table. Continue with:
- Generating Tables to scaffold a new Table class with
make:inertia-table - Basic Usage to wire a table into a controller and an Inertia page
- Columns to define the columns your table renders
- Filtering, Sorting, and Row Actions for interactive features