optimates-de/filament-schedule-monitor

Read-only Filament UI for spatie/laravel-schedule-monitor: scheduled task status, run history and descriptions.

Maintainers

Package info

github.com/OptimatesDE/filament-schedule-monitor

Homepage

pkg:composer/optimates-de/filament-schedule-monitor

Statistics

Installs: 39

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v1.0.0 2026-06-16 10:14 UTC

This package is auto-updated.

Last update: 2026-06-16 10:22:07 UTC


README

A read-only Filament UI for spatie/laravel-schedule-monitor: see your scheduled tasks, their status, last run, run history and descriptions right in the admin panel.

Requirements

  • PHP 8.3+
  • Filament v4 or v5
  • spatie/laravel-schedule-monitor v3 or v4 (pulled in as a dependency)

Installation

composer require optimates-de/filament-schedule-monitor

This package only adds the Filament UI. Set up the underlying monitor as described in the spatie docs:

php artisan vendor:publish --provider="Spatie\ScheduleMonitor\ScheduleMonitorServiceProvider"
php artisan migrate

Run the sync whenever the schedule changes (e.g. on every deploy):

php artisan schedule-monitor:sync

Usage

Register the plugin on a panel:

use OptimatesDE\FilamentScheduleMonitor\FilamentScheduleMonitorPlugin;

$panel->plugin(
    FilamentScheduleMonitorPlugin::make()
        ->navigationGroup('System'), // optional
);

Options

  • ->navigationGroup(string|UnitEnum|null $group) — navigation group for the entry.
  • ->navigationSort(?int $sort) — sort within the group.
  • ->registerNavigation(bool $condition = true) — set to false to keep it out of the main menu (e.g. when linking it from a custom settings page); the resource stays reachable via MonitoredScheduledTaskResource::getUrl('index').

Task descriptions

Descriptions are read live from the registered schedule, so adding ->description('…') to a scheduled task shows up in the UI:

Schedule::command('backup:run')->daily()->description('Create database backup');

License

MIT — see LICENSE.