PHPackages                             sgvcode/filament-kanban - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. sgvcode/filament-kanban

ActiveLibrary[Admin Panels](/categories/admin)

sgvcode/filament-kanban
=======================

Kanban boards for Filament PHP — maintained fork for Filament 5.x

10PHP

Since Jun 19Pushed todayCompare

[ Source](https://github.com/sgvcode/filament-kanban)[ Packagist](https://packagist.org/packages/sgvcode/filament-kanban)[ RSS](/packages/sgvcode-filament-kanban/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

Add kanban boards to your Filament pages
========================================

[](#add-kanban-boards-to-your-filament-pages)

[![Latest Version on Packagist](https://camo.githubusercontent.com/df5ae838af220fff1d5a5070427e38b1c724329a7b175d9eed5e46156838e916/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736776636f64652f66696c616d656e742d6b616e62616e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sgvcode/filament-kanban)[![Total Downloads](https://camo.githubusercontent.com/0fbc665ad62accc8a905e6ddf5ef6fd2d89957bf6371a21cfbd5f5f4f2cd3c23/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f736776636f64652f66696c616d656e742d6b616e62616e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sgvcode/filament-kanban)

Important

**Version 3.x** is the current release for **Filament 5.x** and **Laravel 11/12/13**.

This is a community-maintained fork of [mokhosh/filament-kanban](https://github.com/mokhosh/filament-kanban), updated for Filament 5.x and Laravel 13. The original package is no longer actively maintained.

Note

For **Filament 3.x** (Laravel 9/10/11), use **version 2.x** from the original maintainer: `composer require mokhosh/filament-kanban:^2.0`

Requirements
------------

[](#requirements)

- PHP 8.2+
- Filament 5.x
- Laravel 11.x / 12.x / 13.x
- Livewire 4.x (included with Filament 5.x)

Easily add Kanban board pages to your Filament panels.

[![Customized kanban board views](https://raw.githubusercontent.com/mokhosh/filament-kanban/main/images/client-kanban.png)](https://raw.githubusercontent.com/mokhosh/filament-kanban/main/images/client-kanban.png)

[![Customized edit modal](https://raw.githubusercontent.com/mokhosh/filament-kanban/main/images/client-edit.png)](https://raw.githubusercontent.com/mokhosh/filament-kanban/main/images/client-edit.png)

[![Cards with progress indicator](https://raw.githubusercontent.com/mokhosh/filament-kanban/main/images/prospect-kanban.png)](https://raw.githubusercontent.com/mokhosh/filament-kanban/main/images/prospect-kanban.png)

[![Another example by @Log1x](https://raw.githubusercontent.com/mokhosh/filament-kanban/main/images/organizer-board.png)](https://raw.githubusercontent.com/mokhosh/filament-kanban/main/images/organizer-board.png)

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require sgvcode/filament-kanban
```

If the package is not available on Packagist, add the GitHub repository to your `composer.json`:

```
"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/sgvcode/filament-kanban"
    }
]
```

The package will auto-register with Filament. No additional installation steps required for Filament 5.x.

Before You Start
----------------

[](#before-you-start)

Important

You should have some `Model` with a `status` column. This column can be called `status` in the database or anything else.

I'm also assuming there's a `title` column on your model, but you can have `name` or any other column to represent a title.

I recommend you create a string backed `Enum` to define your statuses.

You can use our `IsKanbanStatus` trait, so you can easily transform your enum cases for the Kanban board using the `statuses` method on your enum.

```
use Mokhosh\FilamentKanban\Concerns\IsKanbanStatus;

enum UserStatus: string
{
    use IsKanbanStatus;

    case User = 'User';
    case Admin = 'Admin';
}
```

I recommend you cast the `status` attribute on your `Model` to the enum that you have created.

Tip

I also recommend you use the [Spatie Eloquent Sortable](https://github.com/spatie/eloquent-sortable) package on your `Model`, and we will magically add sorting abilities to your Kanban boards.

Usage
-----

[](#usage)

You can create a new Kanban board called `UsersKanbanBoard` using this artisan command:

```
php artisan make:kanban UsersKanbanBoard
```

This creates a good starting point for your Kanban board. You can customize the Kanban board to your liking.

You should override the `model` property, so we can load your records.

```
protected static string $model = User::class;
```

You should also override the `statusEnum` property, which defines your statuses.

```
protected static string $statusEnum = UserStatus::class;
```

Upgrade Guide
-------------

[](#upgrade-guide)

### From 1.x to 2.x (Filament 3.x)

[](#from-1x-to-2x-filament-3x)

If you're upgrading from version 1.x, here is your checklist:

- You need to override `$model` and `$statusEnum` as mentioned in [the last part](#usage)
- If you have published `kanban-record.blade.php` view, you can use `$record` as a `Model` instance instead of an `array`.
- If you're overriding `KanbanBoard` methods just to do the default behaviour, you can safely remove them now.

### From 2.x to 3.x (Filament 5.x / Laravel 11-13)

[](#from-2x-to-3x-filament-5x--laravel-11-13)

If you're upgrading from version 2.x to work with Filament 5.x and Laravel 11, 12, or 13:

- Update your `composer.json`:

    ```
    "filament/filament": "^5.0",
    "illuminate/contracts": "^11.0|^12.0|^13.0"
    ```
- Run `composer update`
- If you have custom implementations using `InteractsWithForms`, change to `InteractsWithSchemas`:

    ```
    use Filament\Schemas\Concerns\InteractsWithSchemas;

    trait YourTrait
    {
        use InteractsWithSchemas;
    }
    ```
- If you're using the `getListeners()` method, it now requires explicit implementation. The `HasStatusChange` trait handles this automatically.
- If you're using the edit modal, ensure your blade files use `wire:submit` instead of `wire:submit.prevent`
- If you're using Spatie Eloquent Sortable, no changes needed - it works out of the box

Advanced Usage
--------------

[](#advanced-usage)

You can override the `records` method, to customize how the records or items that you want to see on your board are retrieved.

```
protected function records(): Collection
{
    return User::where('role', 'admin')->get();
}
```

If you don't want to define an `Enum` for your statuses, or you have a special logic for retrieving your statuses, you can override the `statuses` method:

```
protected function statuses(): Collection
{
     return collect([
         ['id' => 'user', 'title' => 'User'],
         ['id' => 'admin', 'title' => 'Admin'],
     ]);
}
```

You can also override these methods to change your board's behavior when records are dragged and dropped:

- `onStatusChanged` which defines what happens when a record is moved between statuses.
- `onSortChanged` which defines what happens when a record is moved inside the same status.

```
public function onStatusChanged(int|string $recordId, string $status, array $fromOrderedIds, array $toOrderedIds): void
{
    User::find($recordId)->update(['status' => $status]);
    User::setNewOrder($toOrderedIds);
}

public function onSortChanged(int|string $recordId, string $status, array $orderedIds): void
{
    User::setNewOrder($orderedIds);
}
```

### Customizing the Status Enum

[](#customizing-the-status-enum)

If you add `IsKanbanStatus` to your status `Enum`, this trait adds a static `statuses()` method to your enum that will return the statuses defined in your enum in the appropriate format.

If you don't want all cases of your enum to be present on the board, you can override this method and return a subset of cases:

```
public static function kanbanCases(): array
{
    return [
        static::CaseOne,
        static::CaseThree,
    ];
}
```

`IsKanbanStatus` uses the `value` of your cases for the `title` of your statuses. You can customize how the title is retrieved as well:

```
public function getTitle(): string
{
    return __($this->label());
}
```

Edit modal
----------

[](#edit-modal)

### Disabling the modal

[](#disabling-the-modal)

Edit modal is enabled by default, and you can show it by clicking on records.

If you need to disable the edit modal override this property:

```
public bool $disableEditModal = false;
```

### Edit modal form schema

[](#edit-modal-form-schema)

You can define the edit modal form schema by overriding this method:

```
protected function getEditModalFormSchema(int|string|null $recordId): array
{
    return [
        TextInput::make('title'),
    ];
}
```

As you can see you have access to the `id` of the record being edited, if that's helpful in building your schema.

### Customizing edit form submit action

[](#customizing-edit-form-submit-action)

You can define what happens when the edit form is submitted by overriding this method:

```
protected function editRecord(int|string $recordId, array $data, array $state): void
{
    Model::find($recordId)->update([
        'phone' => $data['phone']
    ]);
}
```

The `data` array contains the form data, and the `state` array contains the full record data.

### Customizing modal's appearance

[](#customizing-modals-appearance)

You can customize modal's title, size and the labels for save and cancel buttons, or use Filament's slide-over instead of a modal:

```
protected string $editModalTitle = 'Edit Record';

protected string $editModalWidth = '2xl';

protected string $editModalSaveButtonLabel = 'Save';

protected string $editModalCancelButtonLabel = 'Cancel';

protected bool $editModalSlideOver = true;
```

Customization
-------------

[](#customization)

### Changing the navigation icon

[](#changing-the-navigation-icon)

```
protected static ?string $navigationIcon = 'heroicon-o-document-text';
```

### Changing the model property that's used as the title

[](#changing-the-model-property-thats-used-as-the-title)

```
protected static string $recordTitleAttribute = 'title';
```

### Changing the model property that's used as the status

[](#changing-the-model-property-thats-used-as-the-status)

```
protected static string $recordStatusAttribute = 'status';
```

### Customizing views

[](#customizing-views)

You can publish the views using this artisan command:

```
php artisan vendor:publish --tag="filament-kanban-views"
```

I recommend you delete the files that you don't intend to customize and keep the ones you want to change. This way you will get any possible future updates for the original views.

The above method will replace the views for all Kanban boards in your applications.

Alternatively, you might want to change views for one of your boards. You can override each view by overriding these properties:

```
protected static string $view = 'filament-kanban::kanban-board';

protected static string $headerView = 'filament-kanban::kanban-header';

protected static string $recordView = 'filament-kanban::kanban-record';

protected static string $statusView = 'filament-kanban::kanban-status';

protected static string $scriptsView = 'filament-kanban::kanban-scripts';
```

### Flashing Recently Updated Records

[](#flashing-recently-updated-records)

You get some visual feedback when a record has been just updated.

If you're also using [Spatie Eloquent Sortable](https://github.com/spatie/eloquent-sortable) you might experience all records being flashed at the same time. This is because [Eloquent Sortable](https://github.com/spatie/eloquent-sortable) updates the `order_column` of all models when the sort changes. In order to fix that, publish their config and set `ignore_timestamps` to `true`.

Video Tutorial
--------------

[](#video-tutorial)

Are you a visual learner? I have created some Youtube videos to get you started with the package:

Warning

These videos were recorded with version 1.x of the package. For version 2.x/3.x (Filament 5.x), the setup is much simpler and requires less code.

You can still learn the basics, but the implementation details have changed significantly.

[![Creating a Kanban Board in FilamentPHP using filament-kanban: Part 1, Basic setup](https://camo.githubusercontent.com/532749c29ef7e898ea24a17c09c754b75ca433b5b4e117425aaff3945b764627/68747470733a2f2f69332e7974696d672e636f6d2f76692f4771754e546a35304537382f6d617872657364656661756c742e6a7067)](https://www.youtube.com/watch?v=GquNTj50E78)

[![Creating a Kanban Board in FilamentPHP: Part 2, Sorting Records with Spatie Eloquent Sortable](https://camo.githubusercontent.com/d4713be4c712ab276ab66cbe367e7488af31e45bf6c276b88e98d35c0c376fdf/68747470733a2f2f69332e7974696d672e636f6d2f76692f795350783133565a3335732f6d617872657364656661756c742e6a7067)](https://www.youtube.com/watch?v=ySPx13VZ35s)

[![Creating a Kanban Board in FilamentPHP: Part 3, Multiple Kanban boards per model and customizations](https://camo.githubusercontent.com/44dc0d795671532f295811870c1c6164d78b5dfee51bc037439144858f9ba4d4/68747470733a2f2f69332e7974696d672e636f6d2f76692f506b2d795a4972485469512f6d617872657364656661756c742e6a7067)](https://www.youtube.com/watch?v=Pk-yZIrHTiQ)

[![Create a Kanban Task Management App in 15 Minutes: Part 4, Create and Edit Actions](https://camo.githubusercontent.com/43797138a4331ffda624e3da7a10c2d24107697f30dd93c40cf32a566481e595/68747470733a2f2f69332e7974696d672e636f6d2f76692f515a5035374442745872552f6d617872657364656661756c742e6a7067)](https://www.youtube.com/watch?v=QZP57DBtXrU)

[![Create a Kanban Task Management App with FilamentPHP: Part 5, Customize the Views](https://camo.githubusercontent.com/8da736ff2db58148553cc0b5b5874d5070524e10e2ebbfd11b2ce6c97d7c94d9/68747470733a2f2f69332e7974696d672e636f6d2f76692f5246362d326865726e30382f6d617872657364656661756c742e6a7067)](https://www.youtube.com/watch?v=RF6-2hern08)

[![Create a Kanban Task Management App with FilamentPHP: Part 6, Customize the Theme](https://camo.githubusercontent.com/f9de83f7dd9ce93290d5c00083f261f77650eb61f4ad0fc90bd6e036992f2bf4/68747470733a2f2f69332e7974696d672e636f6d2f76692f6879686d45496f577154672f6d617872657364656661756c742e6a7067)](https://www.youtube.com/watch?v=hyhmEIoWqTg)

[![Create a Kanban Task Management App with FilamentPHP: Part 7, Custom Views per Kanban Board](https://camo.githubusercontent.com/e7a8b6419533c5b7b19348bd96dc32414f8b063a9faa8f2ebc4e1be27f0e24cd/68747470733a2f2f69332e7974696d672e636f6d2f76692f57646443617179453044302f6d617872657364656661756c742e6a7067)](https://www.youtube.com/watch?v=WddCaqyE0D0)

Demos and Examples
------------------

[](#demos-and-examples)

- [Kanban Example](https://github.com/mokhosh/filament-kanban-example)
- [Kanban Todo](https://github.com/mokhosh/filament-kanban-todo)

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Mo Khosh](https://github.com/mokhosh)
- [All Contributors](../../contributors)
- The original idea and structure of this package was inspired by [David Vincent](https://github.com/invaders-xx)'s [filament-kanban-board](https://github.com/invaders-xx/filament-kanban-board/) (for Filament 2.x/3.x)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

22

—

LowBetter than 21% of packages

Maintenance65

Regular maintenance activity

Popularity2

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 84.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/106033066?v=4)[SGVero](/maintainers/sgvcode)[@sgvcode](https://github.com/sgvcode)

---

Top Contributors

[![mokhosh](https://avatars.githubusercontent.com/u/6499685?v=4)](https://github.com/mokhosh "mokhosh (246 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (18 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (9 commits)")[![sgvcode](https://avatars.githubusercontent.com/u/106033066?v=4)](https://github.com/sgvcode "sgvcode (7 commits)")[![Log1x](https://avatars.githubusercontent.com/u/5745907?v=4)](https://github.com/Log1x "Log1x (2 commits)")[![dipesh79](https://avatars.githubusercontent.com/u/63183800?v=4)](https://github.com/dipesh79 "dipesh79 (1 commits)")[![brenjt](https://avatars.githubusercontent.com/u/1713885?v=4)](https://github.com/brenjt "brenjt (1 commits)")[![gnovaro](https://avatars.githubusercontent.com/u/270990?v=4)](https://github.com/gnovaro "gnovaro (1 commits)")[![hussain4real](https://avatars.githubusercontent.com/u/45605752?v=4)](https://github.com/hussain4real "hussain4real (1 commits)")[![bencarlson](https://avatars.githubusercontent.com/u/1414587?v=4)](https://github.com/bencarlson "bencarlson (1 commits)")[![ryanmortier](https://avatars.githubusercontent.com/u/2053960?v=4)](https://github.com/ryanmortier "ryanmortier (1 commits)")[![chinmaypurav](https://avatars.githubusercontent.com/u/70144052?v=4)](https://github.com/chinmaypurav "chinmaypurav (1 commits)")[![aislandener](https://avatars.githubusercontent.com/u/12144342?v=4)](https://github.com/aislandener "aislandener (1 commits)")

### Embed Badge

![Health badge](/badges/sgvcode-filament-kanban/health.svg)

```
[![Health](https://phpackages.com/badges/sgvcode-filament-kanban/health.svg)](https://phpackages.com/packages/sgvcode-filament-kanban)
```

###  Alternatives

[leung/laravel-adminer

adminer for laravel5.\*

169.0k](/packages/leung-laravel-adminer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)