Installation

Add the Tapix repository

Register the private Tapix Composer repository in your project:

composer config repositories.tapix composer https://tapix.dev/repo

When prompted, enter the credentials you received after purchasing your license.

Install the package

composer require tapix/core

Publish the configuration

Publish the Tapix configuration file:

php artisan vendor:publish --tag=tapix-config

This creates config/tapix.php. See the Configuration page for a full reference of available options.

Run migrations

Tapix requires several database tables to track imports, mappings, and row data:

php artisan migrate

Include Tapix CSS

Tapix ships with styles that must be included in your Tailwind CSS build.

With Filament

Add the Tapix source path to your tailwind.config.js content array:

export default {
    content: [
        // ...existing paths
        './vendor/tapix/core/resources/**/*.blade.php',
    ],
}

Without Filament

If you are using Tapix outside of a Filament panel, add the same content path and import the Tapix CSS in your main stylesheet:

@import '../../vendor/tapix/core/resources/css/tapix.css';

Register the Filament plugin

Add TapixPlugin to your Filament panel provider. The discoverImporters() method automatically finds all importer classes in your configured importer directories.

use Tapix\Core\Filament\TapixPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            TapixPlugin::make()
                ->discoverImporters(),
        ]);
}

Create your first importer

Generate an importer class using the Artisan command:

php artisan make:tapix-importer ContactImporter

This creates a new importer at app/Importers/ContactImporter.php. Open the file and define your column mappings, validation rules, and processing logic. See the Defining Importers section for detailed guidance.