Getting Started

Installation

Install and migrate the package.

Requirements

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

Install the package

Terminal
composer require relaticle/activity-log

The service provider (Relaticle\ActivityLog\ActivityLogServiceProvider) is auto-discovered. It registers:

  • Config file (config/activity-log.php)
  • Blade views namespaced as activity-log::*
  • Translations (under the activity-log::messages.* namespace)
  • RendererRegistry and TimelineCache singletons
  • A Livewire component registered as activity-log
  • The built-in activity_log renderer

Publish the config (optional)

Terminal
php artisan vendor:publish --tag=activity-log-config

Index the activity_log table

The plugin does not ship a migration (the table is owned by spatie/laravel-activitylog). For good performance on timeline queries, add this compound index:

$table->index(['subject_type', 'subject_id', 'created_at']);

Tailwind source (custom panel themes)

If your panel uses a custom theme.css, include the plugin's views so Tailwind compiles the utilities used by the Blade templates:

resources/css/filament/{panel}/theme.css
@source '../../../../vendor/relaticle/activity-log/resources/views/**/*';
Copyright © 2026