README

Email-like inbox messaging plugin for Filament v5. Add a complete internal messaging system to your admin panel — inbox, sent, starred, trash, threading, forwarding, read receipts, and more.

Screenshots

Inbox	Thread View

Compose Message	Sent Messages

Features

• Inbox, Sent, Starred, Trash — Full Gmail-style navigation
• Message Threading — Reply and Reply All with threaded conversations
• Message Forwarding — Forward messages with original headers
• Read Receipts — Per-recipient read tracking with status indicators
• Star Messages — Mark important messages for quick access
• Rich Text Editor — Compose messages with formatting and file attachments
• Bulk Actions — Mark as read, move to trash in batch
• Search & Filters — Filter by sender, unread, starred
• Database Notifications — Filament native notifications on new messages
• Stats Widget — Unread, total, and starred message counts
• Dark Mode — Full dark mode support
• Multi-tenancy — Filament native tenant scoping
• Configurable User Model — Works with any authenticatable model
• Laravel Events — Hook into MessageSent, MessageRead, MessageStarred, MessageTrashed, MessageRestored, MessageForwarded
• Test Factories — Message and MessageRecipient factories included
• i18n — English, Japanese, Spanish, French, Portuguese (BR), Chinese (Simplified), Korean, German

Requirements

• PHP 8.2+
• Laravel 12+
• Filament v5

Installation

composer require qalainau/filament-inbox

Run the notifications migration (required for Filament database notifications):

php artisan make:notifications-table
php artisan migrate

Add the HasInbox trait to your User model:

use FilamentInbox\Concerns\HasInbox;

class User extends Authenticatable
{
    use HasInbox;
}

Register the plugin in your Filament panel. databaseNotifications() is required to enable Filament's notification system:

use FilamentInbox\FilamentInboxPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->databaseNotifications()
        ->plugin(FilamentInboxPlugin::make());
}

Note: databaseNotifications() requires the notifications table. If you see an error about a missing table, run php artisan make:notifications-table && php artisan migrate.

Configuration

Publish the config file:

php artisan vendor:publish --tag=filament-inbox-config

// config/filament-inbox.php
return [
    // Custom user model (defaults to auth provider model)
    'user_model' => null,

    // Custom users table name (auto-detected from model)
    'users_table' => null,

    // Tenant-users relationship method on tenant model
    // Auto-detects 'members' or 'users' if null
    'tenant_users_relationship' => null,
];

Multi-tenancy

Filament Inbox works with Filament's built-in tenancy. When tenancy is active:

• Messages are scoped to the current tenant
• Recipient options are limited to tenant members
• Tenant is automatically attached to new messages

No additional configuration is needed if your tenant model has a members() or users() relationship.

Events

Listen to messaging events in your EventServiceProvider or with Event::listen():

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

License

The MIT License (MIT). Please see License File for more information.