Filament Right Click

Right-click table row and Flowforge card menus for Filament panels.

This package adds a static right-click menu to Filament table records and, when Flowforge is installed, Kanban board cards. Menu items trigger native Filament actions, so action modals, confirmation, authorization, validation, notifications, redirects, and server-side disabled/hidden checks remain owned by Filament.

Installation

composer require leek/filament-right-click
php artisan filament:assets

Register the plugin on the panels that should support right-click menus:

use Leek\FilamentRightClick\FilamentRightClickPlugin;

$panel
    ->plugin(FilamentRightClickPlugin::make());

Usage

Use contextMenuActions() for single-record row menu items and contextMenuBulkActions() for selected-record menu items:

use Filament\Actions\Action;
use Filament\Actions\BulkAction;
use Filament\Actions\DeleteAction;
use Filament\Support\Icons\Heroicon;
use Filament\Tables\Table;
use Leek\FilamentRightClick\Menu\ContextMenuItem;
use Leek\FilamentRightClick\Menu\ContextMenuSection;
use Leek\FilamentRightClick\Menu\ContextMenuSeparator;

public static function table(Table $table): Table
{
    return $table
        ->columns([
            // ...
        ])
        ->contextMenuActions([
            ContextMenuSection::make([
                ContextMenuItem::for(
                    Action::make('archive')
                        ->requiresConfirmation()
                        ->action(fn ($record) => $record->archive()),
                )
                    ->label('Archive')
                    ->icon(Heroicon::ArchiveBox)
                    ->color('warning'),
            ])->label('Manage'),

            ContextMenuSeparator::make(),

            ContextMenuItem::for(DeleteAction::make())
                ->label('Delete')
                ->icon(Heroicon::Trash)
                ->color('danger'),
        ])
        ->contextMenuBulkActions([
            ContextMenuItem::forBulkAction(
                BulkAction::make('archiveSelected')
                    ->label('Archive Selected')
                    ->requiresConfirmation()
                    ->action(fn ($records) => $records->each->archive()),
            )
                ->icon(Heroicon::ArchiveBox)
                ->color('warning'),
        ]);
}

The wrapped actions are registered as table actions, but they are not rendered in the normal row action column. On click, the package calls Filament's table action mounting path for the row record key.

Bulk actions are registered as table bulk actions without rendering in the normal bulk action dropdown. When the right-clicked row is already selected, the bulk menu uses the current Filament selection, including select-all-across-pages state. When the right-clicked row is not selected, the single-record menu opens instead.

Flowforge cards

If relaticle/flowforge is installed, the plugin also registers a contextMenuCardActions() macro on Flowforge boards:

use Filament\Actions\Action;
use Filament\Support\Icons\Heroicon;
use Leek\FilamentRightClick\Menu\ContextMenuItem;
use Relaticle\Flowforge\Board;

public function board(Board $board): Board
{
    return $board
        ->query(Task::query())
        ->columns([
            // ...
        ])
        ->recordActions([
            // Visible card actions...
        ])
        ->contextMenuCardActions([
            ContextMenuItem::for(
                Action::make('viewTask')
                    ->label('View Task')
                    ->action(fn ($record) => $this->viewTask($record)),
            )
                ->icon(Heroicon::Eye),

            ContextMenuItem::for(
                Action::make('archiveTask')
                    ->requiresConfirmation()
                    ->action(fn ($record) => $record->archive()),
            )
                ->label('Archive')
                ->icon(Heroicon::ArchiveBox)
                ->color('warning'),
        ]);
}

Flowforge card context actions are registered with Filament's action cache, but they are not added to Flowforge's visible card action group. On click, the package calls Flowforge's native card action mounting path with the card's recordKey.

Screenshot

Behavior

• Right-click opens the menu anywhere on a table row except existing interactive controls.
• The browser context menu is only suppressed for rows in tables with configured right-click actions.
• ContextMenu keyboard key and Shift+F10 open the menu for the focused or last-hovered row.
• Escape closes the menu, arrow keys move through items, and Enter / Space trigger the focused item.
• Touch and long-press gestures are intentionally not included in v1.

Static menu, server-enforced actions

The menu label, icon, and color are static metadata on ContextMenuItem. The underlying Filament action still decides whether the operation can run for the specific record.

If a right-click item points to an action that is hidden, disabled, or unauthorized for a row, Filament will refuse to mount it. The menu closes and no client-side policy decision is made.

Asset loading

Assets are registered as loadedOnRequest() and are requested only by tables that use contextMenuActions() or contextMenuBulkActions().

If you publish or bundle assets in your own build pipeline, keep the DOM contract intact:

• table root record menu: data-filament-right-click-record-config
• table root bulk menu: data-filament-right-click-bulk-config
• legacy table root record menu: data-filament-right-click-config
• Flowforge board card menu: data-filament-right-click-flowforge-card-config
• row key source: Filament's native row wire:key
• Flowforge card key source: data-card-id
• record action call: mountTableAction(actionName, recordKey)
• Flowforge card action call: mountAction(actionName, [], { recordKey })
• bulk action call: synchronize Filament's selected table record properties, then mount the bulk action

Bulk actions

Use contextMenuBulkActions() with ContextMenuItem::forBulkAction() or pass a BulkAction directly:

use Filament\Actions\BulkAction;
use Leek\FilamentRightClick\Menu\ContextMenuItem;

$table->contextMenuBulkActions([
    ContextMenuItem::forBulkAction(
        BulkAction::make('deleteSelected')
            ->label('Delete Selected')
            ->requiresConfirmation()
            ->action(fn ($records) => $records->each->delete()),
    )
        ->color('danger'),
]);

Bulk actions are still server-enforced by Filament. Hidden, disabled, and unauthorized actions will not mount.

Compatibility

This package targets Filament v4 and v5.

Flowforge support is optional and is registered only when Relaticle\Flowforge\Board exists.

Record actions use Filament's table action mounting path. Bulk actions use the newer unified mountAction() path when available and fall back to Filament's table bulk action compatibility method.