---
title: Installation
---
## Requirements
Filament has a few requirements to run:
- PHP 8.0+
- Laravel v8.0+
- Livewire v2.0+
The table builder comes pre-installed inside the [admin panel 2.x](/docs/admin/2.x), but you must still follow the installation instructions below if you're using it in the rest of your app.
## New Laravel projects
To get started with the table builder quickly, you can set up [Alpine.js](https://alpinejs.dev), [TailwindCSS](https://tailwindcss.com) and [Livewire](https://laravel-livewire.com) with these commands:
```bash
composer require filament/tables:"^2.0"
php artisan tables:install
npm install
npm run dev
```
> These commands will ruthlessly overwrite existing files in your application, hence why we only recommend using this method for new projects.
You're now ready to start [building tables](getting-started)!
## Existing Laravel projects
You may download the table builder using Composer:
```bash
composer require filament/tables:"^2.0"
```
The package uses [Alpine.js](https://alpinejs.dev), [Tailwind CSS](https://tailwindcss.com), the Tailwind Forms plugin, and the Tailwind Typography plugin. You may install these through NPM:
```bash
npm install alpinejs @alpinejs/focus tailwindcss @tailwindcss/forms @tailwindcss/typography --save-dev
```
To finish installing Tailwind, you must create a new `tailwind.config.js` file in the root of your project. The easiest way to do this is by running `npx tailwindcss init`.
In `tailwind.config.js`, register the plugins you installed, and add custom colors used by the table builder:
```js
const colors = require('tailwindcss/colors')
module.exports = {
content: [
'./resources/**/*.blade.php',
'./vendor/filament/**/*.blade.php', // [tl! focus]
],
theme: {
extend: {
colors: { // [tl! focus:start]
danger: colors.rose,
primary: colors.blue,
success: colors.green,
warning: colors.yellow,
}, // [tl! focus:end]
},
},
plugins: [
require('@tailwindcss/forms'), // [tl! focus:start]
require('@tailwindcss/typography'), // [tl! focus:end]
],
}
```
Of course, you may specify your own custom `primary` and `danger` colors, which will be used instead.
In your `webpack.mix.js` file, Register Tailwind CSS as a PostCSS plugin :
```js
const mix = require('laravel-mix')
mix.js('resources/js/app.js', 'public/js')
.postCss('resources/css/app.css', 'public/css', [
require('tailwindcss'), // [tl! focus]
])
```
In `/resources/css/app.css`, import `filament/forms` vendor CSS and [TailwindCSS](https://tailwindcss.com):
```css
@import '../../vendor/filament/forms/dist/module.esm.css';
@tailwind base;
@tailwind components;
@tailwind utilities;
```
In `/resources/js/app.js`, import [Alpine.js](https://alpinejs.dev), the `filament/forms` and `@alpinejs/focus` plugins, and register them:
```js
import Alpine from 'alpinejs'
import FormsAlpinePlugin from '../../vendor/filament/forms/dist/module.esm'
import Focus from '@alpinejs/focus'
Alpine.plugin(FormsAlpinePlugin)
Alpine.plugin(Focus)
window.Alpine = Alpine
Alpine.start()
```
Compile your new CSS and JS assets using `npm run dev`.
Finally, create a new `resources/views/layouts/app.blade.php` layout file for Livewire components:
```blade
{{ config('app.name') }}
@livewireStyles
@livewireScripts
@stack('scripts')
{{ $slot }}
```
You're now ready to start [building tables](getting-started)!
## Publishing the configuration
If you wish, you may publish the configuration of the package using:
```bash
php artisan vendor:publish --tag=tables-config
```
## Publishing the translations
If you wish to translate the package, you may publish the language files using:
```bash
php artisan vendor:publish --tag=tables-translations
```
## Upgrade Guide
To upgrade the package to the latest version, you must run:
```bash
composer update
php artisan config:clear
php artisan view:clear
```
To do this automatically, we recommend adding these commands to your `composer.json`'s `post-update-cmd`:
```json
"post-update-cmd": [
// ...
"@php artisan config:clear",
"@php artisan view:clear"
],
```