Getting Started

Installation

Install and configure the FilaForms core plugin.

Requirements

PHP: 8.3+
Laravel: 11+ or 12+
Filament: 4.x or 5.x
Tailwind CSS: 4.0+
Database: MySQL, PostgreSQL, or SQLite

FilaForms ships two major branches: 2.x for Filament 4 and 3.x for Filament 5. Composer resolves the correct branch automatically based on your Filament version.

Commercial License

FilaForms is a commercial package. Purchase a license at filaforms.app or contact hello@filaforms.app. After purchase you will receive a license key and access credentials via email.

Setup

Add Private Repository

Add the FilaForms Composer repository to your composer.json:

composer.json

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://composer.filaforms.app"
        }
    ]
}

Install Package

Terminal

composer require filaforms/core

When prompted for credentials:

Username: your purchase email address
Password: your license key

FilaForms automatically installs the Custom Fields plugin as a dependency.

Configure Multi-Tenancy (Optional)

Multi-tenancy must be configured before running migrations. If you skip this step now, you will need to create a manual migration later to add the tenant column.

Publish the config file and enable multi-tenancy:

Terminal

php artisan vendor:publish --tag="filaforms-config"

config/filaforms.php

'features' => FeatureConfigurator::configure()
    ->enable(FilaFormsFeature::MULTI_TENANCY)

See Configuration for full multi-tenancy setup.

Run Migrations

Terminal

php artisan migrate

Include CSS Assets

If you haven't set up a custom Filament theme, follow the Filament theme guide first.

Add the plugin views to your theme CSS file:

resources/css/filament/admin/theme.css

@source "../../../../vendor/filaforms/core/resources/views/**/*.blade.php";
@source "../../../../vendor/relaticle/custom-fields/resources/views/**/*.blade.php";

Register the Plugin

Add FilaFormsPlugin to your Filament panel provider:

app/Providers/Filament/AdminPanelProvider.php

use FilaForms\Core\FilaFormsPlugin;

$panel
    ->plugins([
        FilaFormsPlugin::make(),
    ]);

Verification

After installation, you should see Fila Forms in your Filament navigation menu. Click it to access the form builder and start creating forms.

Configuration

Configure feature flags, storage, security, routes, and multi-tenancy.