relaticle/activity-log

Reusable Filament plugin that renders a unified activity-log timeline for any Eloquent model

v1.0.0-alpha.1 2026-04-20 09:16 UTC

Requires

• php: ^8.4
• filament/filament: ^5.0
• illuminate/contracts: ^12.0
• illuminate/database: ^12.0
• illuminate/support: ^12.0
• spatie/laravel-activitylog: ^5.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• orchestra/testbench: ^10.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• pestphp/pest-plugin-livewire: ^4.0

MIT

README

A unified chronological timeline for any Eloquent model. Aggregates spatie/laravel-activitylog events (own log + related logs), timestamp columns on related models, and any custom source you define — all in one Filament-native feed.

Features

• Unified timeline — merge spatie logs, related-model timestamps, and custom events into one stream
• Pluggable sources — fromActivityLog, fromActivityLogOf, fromRelation, fromCustom, and custom TimelineSource classes
• Per-event renderers — Blade views, closures, or renderer classes bound per event or type
• Filament-native UX — infolist component, relation manager, and header-action slide-over
• Dedup + filtering — type/event allow/deny lists, date windows, priority-based dedup with override
• Opt-in caching — per-call TTL with explicit invalidation — no model observers

Requirements

• PHP 8.4+
• Laravel 12
• Filament 5
• spatie/laravel-activitylog ^5

Installation

composer require relaticle/activity-log

Usage

Make the model timeline-capable, then render it on a Filament resource:

use Relaticle\ActivityLog\Concerns\InteractsWithTimeline;
use Relaticle\ActivityLog\Contracts\HasTimeline;
use Relaticle\ActivityLog\Timeline\TimelineBuilder;
use Spatie\Activitylog\Traits\LogsActivity;

class Person extends Model implements HasTimeline
{
    use InteractsWithTimeline;
    use LogsActivity;

    public function timeline(): TimelineBuilder
    {
        return TimelineBuilder::make($this)->fromActivityLog();
    }
}

use Filament\Schemas\Schema;
use Relaticle\ActivityLog\Filament\Infolists\Components\ActivityLog;

public static function infolist(Schema $schema): Schema
{
    return $schema->components([
        ActivityLog::make('activity')->columnSpanFull(),
    ]);
}

View Complete Documentation →

Our Ecosystem

FilaForms Visual form builder for all your public-facing forms. Learn more →

Custom Fields Let users add custom fields to any model without code changes. Learn more →

Flowforge Drag-and-drop Kanban for any Laravel model. Learn more →

Contributing

Contributions are welcome. Please see CONTRIBUTING.md before opening an issue or pull request.

Security

If you discover a security issue, please review our Security Policy.

Changelog

Please see CHANGELOG.md for recent changes.

License

MIT License. See LICENSE.md for details.