Installation

​

After purchase: Lemon key vs portal keys (read this first)

1. Open the License Portal.
2. Register with:
   • your email (same as Lemon checkout when possible),
   • a password for the portal,
   • your Lemon Squeezy license key.
3. After registration, the portal generates two credentials for you:
   • Composer token (cmp_…) — only for composer config --auth / CI, so you can download the package.
   • Public API key (pk_forms_…) — only for Filament (Global Settings → License → License public key), so Studio unlocks on registered domains.

​

Step-by-step installation

​

1. Buy and register on the License Portal

1. Purchase from the Flex Forms store.
2. Copy your Lemon Squeezy license key from the receipt email or My Orders.
3. Go to license.bjanczak.com/flex-forms/panel.
4. Create an account: email + password + paste the Lemon license key when asked.
5. After signup, the portal shows your generated Composer token (cmp_…) and Public API key (pk_forms_…). Keep both; you will use cmp_… on this page and pk_forms_… in Activate license.

​

2. Copy your Composer token

1. In the portal, open Install via Composer.
2. Copy the token starting with cmp_ (and the ready-made commands if shown).
3. Store it in a password manager. You need it on every machine that runs composer install / composer update for this project (laptop, CI, Forge, etc.).

​

3. Point Composer at the private registry

composer config repositories.flex-forms composer https://composer.bjanczak.com

"repositories": {
    "flex-forms": {
        "type": "composer",
        "url": "https://composer.bjanczak.com"
    }
}

​

4. Authenticate to the registry

composer config --auth http-basic.composer.bjanczak.com token YOUR_COMPOSER_TOKEN

​

5. Require the package

composer require janczakb/filament-flex-forms

​

6. Publish assets and run migrations

php artisan flex-forms:install

1. Publishes Flex Forms assets (filament-flex-forms-assets)
2. Optionally publishes translations with --translations
3. Runs php artisan filament:assets
4. Asks to run php artisan migrate (or runs them when non-interactive / --force)

php artisan flex-forms:install --force
php artisan flex-forms:install --translations

php artisan migrate

php artisan vendor:publish --tag=filament-flex-forms-config

​

7. Register the plugin on your Filament panel

use Bjanczak\FilamentFlexForms\FilamentFlexFormsPlugin;
use Filament\Panel;

public function panel(Panel $panel): Panel
{
    return $panel
        // ... existing ->id(), ->path(), ->login(), resources, etc.
        ->plugin(
            FilamentFlexFormsPlugin::make()
            // Optional:
            // ->navigationIcon('heroicon-o-envelope')
            // ->navigationLabel('Forms')
            // ->navigationGroup('Flex Forms')
            // ->navigationSort(10)
            // ->navigation(false)
        );
}

​

8. Activate the license (required)

1. Register every hostname you use in the License Portal.
2. Paste the portal-generated Public API key (pk_forms_…) into Global Settings → License → License public key.

​

Prerequisites

​

Which key goes where

​

Production checklist after install

​

CI / CD (GitHub Actions, GitLab, Forge)

- name: Authenticate Flex Forms
  run: |
    composer config repositories.flex-forms composer https://composer.bjanczak.com
    composer config --auth http-basic.composer.bjanczak.com token "${{ secrets.FLEX_FORMS_COMPOSER_TOKEN }}"

- name: Install Dependencies
  run: composer install --no-interaction --prefer-dist

​

Upgrading

​

Troubleshooting

​

Related pages