README

A full-featured commenting system for Filament panels with threaded replies, @mentions, emoji reactions, and real-time updates.

Features

• Threaded Replies - Nested comment threads with configurable depth limits
• @Mentions - Autocomplete user mentions with customizable resolver
• Emoji Reactions - 6 built-in reactions with configurable emoji sets
• File Attachments - Image and document uploads with validation
• Notifications & Subscriptions - Database and mail notifications with auto-subscribe
• Multi-tenancy - Built-in tenant isolation for multi-tenant applications
• 3 Filament Integrations - Slide-over action, table action, and infolist entry

Requirements

• PHP: 8.2+
• Laravel: 12+
• Livewire: 3.5+ / 4.x
• Filament: 4.x / 5.x

Getting Started

composer require relaticle/comments

Publish and run migrations:

php artisan vendor:publish --tag=comments-migrations
php artisan migrate

Setting Up Your Models

use Relaticle\Comments\Concerns\HasComments;
use Relaticle\Comments\Contracts\Commentable;

class Project extends Model implements Commentable
{
    use HasComments;
}

Register the Filament Plugin

use Relaticle\Comments\CommentsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            CommentsPlugin::make(),
        ]);
}

Add Comments to Your Resources

use Relaticle\Comments\Filament\Actions\CommentsAction;

protected function getHeaderActions(): array
{
    return [
        CommentsAction::make(),
    ];
}

Documentation

For complete installation instructions, configuration options, multi-tenancy setup, and examples, visit our documentation.

Contributing

Contributions are welcome! Please see our contributing guide in the documentation.

License

MIT License. See LICENSE for details.