Easy Kanban Board by Mustafa Khaled
CommunityAn advanced Kanban Board package for Filament. Drop it into any Resource's List page to replace the table with a fully interactive board.
Author:
Mustafa Khaled
Package health
Automated checks of this plugin's Composer package
15 checks
- Skipped: GitHub Actions pinned to SHA
- Skipped: GitLab CI includes pinned to SHA
- Passed: Open security advisories
- Passed: Dependabot PR responsiveness — No open Dependabot PRs.
- Skipped: Renovate MR responsiveness
- Failed: Dependabot or Renovate configured — No dependency updater configuration found. View details on Plumb
- Skipped: Dependency update cooldown configured
- Failed: Provides a security policy — View details on Plumb
- Passed: Abandoned or archived — No consulted source marks the package abandoned (packagist, github).
- Warning: Commit and release recency — Low activity: last commit 181 days ago; last release 181 days ago.
-
Passed:
composer.lock not committed by library
—
composer.lockis absent from the released dist archive. - Passed: Dist archive is lean
-
Passed:
Current Laravel version supported
—
Package dependencies resolve together with current Laravel
13.0. -
Passed:
Current PHP version supported
—
Constraint
^8.2supports current PHP8.5. - Skipped: Current Symfony version supported
filament/
namespace. Review the source and install at your own risk. Found
malware or an unresolved security issue the author won't
address?
Report it
.
Documentation
- Requirements
- Features
- Installation
- Quick Start
- KanbanStatusEnum Interface
- Configuration
- Custom Theme
- Testing
- License
An advanced Kanban Board package for Filament. Drop it into any Resource's List page to replace the table with a fully interactive board.
#Requirements
- PHP 8.3+
- Laravel 13+
- Filament 4+
#Features
- Drag-and-drop cards between columns (SortableJS)
- Enum-based or relationship-based columns
KanbanStatusEnuminterface for defining transitions & WIP limits on the enum itself- Card click action (modal, slide-over, or custom)
- Card footer actions (edit, delete, URL navigation, custom)
- Column header actions (create with pre-filled status)
- Filters dropdown with active count badge & reset
- Search bar with relationship support
- Collapsible columns (persisted in localStorage)
- WIP limits with visual warnings and server-side enforcement
- Column summaries (aggregates)
- Empty state per column
- Drag constraints (client-side + server-side)
canMove()callback for custom authorization- Resource policy authorization on every move
- Loading indicator
- Custom views (card, column, board)
- Dark mode support
- Accessibility (ARIA roles, labels, keyboard-friendly)
- Publishable Blade views
- Error notifications on failed moves
#Installation
composer require wezlo/filament-kanban
Register the plugin in your Panel Provider:
use Wezlo\FilamentKanban\FilamentKanbanPlugin;
->plugins([
FilamentKanbanPlugin::make(),
])
#Quick Start
Add HasKanbanBoard to your Resource's List page and define kanban():
use Wezlo\FilamentKanban\Concerns\HasKanbanBoard;
use Wezlo\FilamentKanban\KanbanBoard;
class ListLeads extends ListRecords
{
use HasKanbanBoard;
protected static string $resource = LeadResource::class;
public function kanban(KanbanBoard $kanban): KanbanBoard
{
return $kanban
->enumColumn('status', LeadStatus::class)
->cardTitle(fn ($record) => $record->title)
->cardDescription(fn ($record) => $record->assignee?->name);
}
}
The board replaces the table. Columns are generated from your enum. The breadcrumb shows "Board" instead of "List".
#KanbanStatusEnum Interface
For full integration, implement KanbanStatusEnum on your enum. This lets you define allowed transitions and WIP limits directly on the enum -- no board configuration needed.
use Filament\Support\Contracts\HasIcon;
use Filament\Support\Icons\Heroicon;
use Wezlo\FilamentKanban\Contracts\KanbanStatusEnum;
enum LeadStatus: string implements HasIcon, KanbanStatusEnum
{
case New = 'new';
case Contacted = 'contacted';
case SiteVisit = 'site_visit';
case Negotiation = 'negotiation';
case Won = 'won';
case Lost = 'lost';
// Required by HasLabel (via KanbanStatusEnum)
public function getLabel(): string
{
return match ($this) {
self::New => 'New',
self::Contacted => 'Contacted',
// ...
};
}
// Required by HasColor (via KanbanStatusEnum)
public function getColor(): string
{
return match ($this) {
self::New => 'info',
self::Contacted => 'warning',
// ...
};
}
// Optional: HasIcon
public function getIcon(): Heroicon
{
return match ($this) {
self::New => Heroicon::Sparkles,
// ...
};
}
// Define which statuses each status can transition to.
// Return null to allow all transitions.
public function getAllowedTransitions(): ?array
{
return match ($this) {
self::New => [self::Contacted, self::Lost],
self::Contacted => [self::SiteVisit, self::Lost],
self::SiteVisit => [self::Negotiation, self::Lost],
self::Negotiation => [self::Won, self::Lost],
self::Won => null, // no constraints
self::Lost => null,
};
}
// Set max cards per column. Return null for unlimited.
public function getWipLimit(): ?int
{
return match ($this) {
self::Negotiation => 10,
default => null,
};
}
}
The board automatically reads these -- just use ->enumColumn('status', LeadStatus::class) and transitions + WIP limits are enforced both client-side and server-side.
Without the interface: Regular BackedEnum with HasLabel + HasColor still works. You just configure constraints on the board instead.
Explicit overrides: Board-level ->dragConstraints() and ->wipLimits() override enum values per column.
#Configuration
#Column Source
Enum-based (columns from a BackedEnum):
->enumColumn('status', LeadStatus::class)
Relationship-based (columns from a related model):
->relationshipColumn('stage', 'name', Stage::class, orderAttribute: 'sort_order')
#Card Content
->cardTitle(fn ($record) => $record->title)
->cardDescription(fn ($record) => $record->assignee?->name)
->cardBadges(fn ($record) => [
['label' => $record->priority->getLabel(), 'color' => $record->priority->getColor()],
])
#Card Click Action
Pass any Filament Action to fire when a card is clicked:
use Filament\Actions\Action;
use Filament\Infolists\Components\TextEntry;
->cardAction(
Action::make('view')
->slideOver()
->schema([
TextEntry::make('title'),
TextEntry::make('status')->badge(),
])
->fillForm(fn ($record) => $record->toArray())
->modalSubmitAction(false)
->modalCancelActionLabel('Close')
)
Clicking opens the modal. Dragging still works -- the package distinguishes clicks from drags using SortableJS events.
#Card Footer Actions
Icon buttons at the bottom of each card. Actions with ->url() render as links, others use Livewire modals.
use Filament\Actions\Action;
use Filament\Support\Icons\Heroicon;
->cardFooterActions([
Action::make('edit')
->icon(Heroicon::PencilSquare)
->color('gray')
->url(fn ($record) => LeadResource::getUrl('edit', ['record' => $record])),
Action::make('delete')
->icon(Heroicon::Trash)
->color('danger')
->requiresConfirmation()
->action(fn ($record) => $record->delete()),
])
#Column Header Action
"+" button per column. The column value is pre-filled into the form.
use Filament\Actions\CreateAction;
->columnHeaderAction(CreateAction::make())
#Filters
Renders as a dropdown panel triggered by a filter icon next to the search bar. Shows active filter count as a badge.
use Filament\Forms\Components\Select;
->filters([
Select::make('priority')
->options(LeadPriority::class)
->placeholder('All Priorities'),
Select::make('assigned_to')
->relationship('assignee', 'name')
->placeholder('All Assignees'),
])
->filtersColumns(2) // grid columns inside the dropdown
#Search
->searchable(['title', 'client.user.name'])
Supports dot notation for relationship columns.
#Collapsible Columns
->collapsible()
State persisted per column in localStorage.
#WIP Limits
Define on the enum via KanbanStatusEnum::getWipLimit(), or on the board:
->wipLimits(['new' => 5, 'in_progress' => 10])
->defaultWipLimit(20)
The count badge turns red when over limit. Moves into over-limit columns are blocked server-side with a notification.
#Column Summaries
->columnSummary(function ($records, $column) {
$total = $records->sum('estimated_budget');
return $total > 0 ? 'SAR ' . number_format($total, 0) : null;
})
#Empty State
->emptyState('No leads', 'Drag leads here or create a new one')
#Drag Constraints
Define on the enum via KanbanStatusEnum::getAllowedTransitions(), or on the board:
->dragConstraints([
'new' => [LeadStatus::Contacted, LeadStatus::Lost],
'contacted' => [LeadStatus::SiteVisit, LeadStatus::Lost],
])
Enforced both client-side (SortableJS put function) and server-side (before DB update).
#Authorization
Resource policy: The package checks Resource::canEdit($record) before every move. Unauthorized moves show a danger notification.
canMove callback: Custom business logic:
->canMove(function ($record, $oldStatus, $newStatus) {
if ($newStatus === 'won') {
return auth()->user()->hasRole('project-manager');
}
return true;
})
Order of checks: Resource policy -> Drag constraints -> WIP limits -> canMove callback. First failure blocks the move.
#Move Callback
Run logic after a successful move:
->onRecordMoved(function ($record, $fromValue, $toValue) {
activity()->performedOn($record)->log("Moved from {$fromValue} to {$toValue}");
})
#Query Customization
->modifyQueryUsing(fn ($query) => $query->where('company_id', auth()->user()->company_id))
->recordsPerColumn(50)
->excludeColumns([LeadStatus::Lost])
#Column Appearance
->columnWidth('320px')
->columnColor(fn ($column) => $column->color ?? 'gray')
#Custom Views
Override any view:
->cardView('leads.kanban.card') // receives $record, $board, $column
->columnView('leads.kanban.column') // receives $column, $board
->boardView('leads.kanban.board')
Or publish all views:
php artisan vendor:publish --tag=filament-kanban-views
#Loading Indicator
Enabled by default. Shows a spinner overlay during Livewire updates.
->loading(false) // disable
#Custom Theme
If you have a custom Filament theme, add the package views to your @source directive:
@source '../../../../vendor/wezlo/filament-kanban/resources/views/**/*';
#Testing
php artisan test --filter=KanbanBoard
#License
MIT
The author
From the same author
Modal Notifications
Render any Filament notification as a blocking modal by chaining one method: ->asModal(). Multiple modal notifications fired in the same request are queued one at a time — the user dismisses one and the next slides in, no stacking.
Author:
Mustafa Khaled
Workspace Tabs
Browser-like tabs for Filament panels. Open multiple pages in tabs without losing context, drag to reorder, pin frequently accessed pages, and right-click for quick actions.
Author:
Mustafa Khaled
Record Freezer
Freeze individual Eloquent records against modification — finalised contracts, audited financial periods, legal holds
Author:
Mustafa Khaled
Record Watcher
Subscribe to individual Eloquent records and receive in-panel Filament notifications whenever they change — with the actor (who) and a field-level diff (what). Watches can carry conditions ("only if status changes", "only if amount > 10K"), can be paused, and live on a personal **My Watches** page scoped to the authenticated user. Every fan-out is also persisted to a permanent event log, so users can review the full change history even after dismissing notifications.
Author:
Mustafa Khaled
Featured Plugins
A selection of plugins curated by the Filament team
Blueprint
Filament Blueprint is a premium Laravel Boost extension that helps AI agents produce accurate, detailed implementation plans and security reports for Filament apps.
Filament
Custom Fields
Eliminate custom field migrations forever. Let your users create and manage form fields directly in Filament admin panels with 20+ built-in field types, validation, and zero database changes.
Relaticle
Noir Theme
A theme that gives panels a focused, refined look with near-black surfaces, crisp actions, and restrained color.
Filament