tales-virtualy / filament-kanban-board
A reusable Kanban board for Filament PHP.
Installs: 7
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
pkg:composer/tales-virtualy/filament-kanban-board
Requires
- php: ^8.2
- filament/filament: ^3.0|^4.0
- livewire/livewire: ^3.0
- spatie/laravel-package-tools: ^1.16
README
A beautiful, interactive Kanban Board for Filament Panels. Manage your tasks with drag-and-drop, checklists, attachments, comments, and activity logs.
Features
- 🚀 Interactive Kanban Board: Drag and drop cards between lists.
- 📋 Checklists: Add and manage checklists within cards.
- 📎 Attachments: Upload and manage files attached to cards.
- 💬 Comments: Team collaboration with card-level commenting.
- 🕒 Activity logs: Track everything that happens on a card.
- 👥 Member Management: Assign members to boards and cards.
- 🏷️ Tags: Categorize cards with custom tags.
- 📅 Due Dates: Set and track deadlines.
- 🔒 Privacy: Private or public boards.
Installation
You can install the package via composer:
composer require tales-virtualy/filament-kanban-board
Publish the configuration, migrations, and assets:
php artisan vendor:publish --tag="filament-kanban-board-config" php artisan vendor:publish --tag="filament-kanban-board-migrations" php artisan migrate
Configuration
The configuration file config/kanban.php allows you to customize:
-
user_model: The model used for users (default:App\Models\User). -
system_user_id: ID used for system-generated activity logs. -
storage_disk: Disk used for attachments (default:public). -
table_names: Customize database table names. -
table_names: Customize database table names.
Styling
This package uses Tailwind CSS for styling. To ensure the board looks correct, you must include the package's views in your project's tailwind.config.js or resources/css/app.css (for Tailwind v4).
For Tailwind v4 (app.css):
Add the @source directive to your resources/css/app.css:
@import 'tailwindcss'; @source '../../vendor/tales-virtualy/filament-kanban-board/resources/views/**/*.blade.php'; /* ... other imports */
For Tailwind v3 (tailwind.config.js):
Add the Views path to the content array:
module.exports = { content: [ './resources/**/*.blade.php', './vendor/tales-virtualy/filament-kanban-board/resources/views/**/*.blade.php', ], // ... }
Usage
Registering the Plugin
Add the plugin to your Filament Panel Provider:
use FilamentKanban\FilamentKanbanPlugin; public function panel(Panel $panel): Panel { return $panel ->plugins([ FilamentKanbanPlugin::make(), ]); }
Accessing the Boards
Once registered, you can access the Kanban boards at /admin/boards (or your panel's equivalent).
Credits
License
The MIT License (MIT). Please see License File for more information.