PHPackages                             muhammadsadeeq/laravel-activitylog-ui - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Logging &amp; Monitoring](/categories/logging)
4. /
5. muhammadsadeeq/laravel-activitylog-ui

ActiveLibrary[Logging &amp; Monitoring](/categories/logging)

muhammadsadeeq/laravel-activitylog-ui
=====================================

A beautiful, modern UI for Spatie's Activity Log with advanced filtering, analytics, and real-time features.

v2.0.1(4mo ago)17920.1k↓27.2%8[2 issues](https://github.com/MuhammadSadeeq/laravel-activitylog-ui/issues)[1 PRs](https://github.com/MuhammadSadeeq/laravel-activitylog-ui/pulls)MITBladePHP ^8.4

Since Jul 4Pushed 4mo ago3 watchersCompare

[ Source](https://github.com/MuhammadSadeeq/laravel-activitylog-ui)[ Packagist](https://packagist.org/packages/muhammadsadeeq/laravel-activitylog-ui)[ Docs](https://github.com/MuhammadSadeeq/laravel-activitylog-ui)[ RSS](/packages/muhammadsadeeq-laravel-activitylog-ui/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (6)Dependencies (12)Versions (8)Used By (0)

Laravel Activity Log UI
=======================

[](#laravel-activity-log-ui)

> Beautiful, modern UI for [Spatie's Activity Log](https://github.com/spatie/laravel-activitylog)
>
> **Important:** This package **assumes you already have Spatie's Activity Log installed and configured** in your Laravel application. It does *not* replace the logging package—only provides a powerful UI for viewing and analyzing the stored activities.

[![Activity Log UI Screenshot](laravel-activitylog-ui-screenshot.png)](laravel-activitylog-ui-screenshot.png)

---

📖 Documentation
---------------

[](#-documentation)

📚 **[Complete Documentation](https://www.sadeeq.dev/docs/laravel-activitylog-ui)** - Comprehensive guide with advanced features, customization options, and troubleshooting.

---

⬆️ Upgrading from v1.x
----------------------

[](#️-upgrading-from-v1x)

v2.0 is a breaking release targeting Spatie laravel-activitylog v5. See **[UPGRADING.md](UPGRADING.md)** for the full migration guide.

---

✨ Features
----------

[](#-features)

- Table, Timeline &amp; Analytics dashboards
- Powerful filter panel (date presets, events, users, subjects, search)
- Saved views, per-page &amp; sorting preferences
- Export to **CSV / Excel / PDF / JSON**
    \* Optional Excel &amp; PDF exports require additional packages (see below)
- Real-time count &amp; pagination powered by Laravel cache
- Authorization gate, middleware &amp; granular access lists
- Tailwind CSS &amp; Alpine.js – no build step required

🗒️ Requirements
---------------

[](#️-requirements)

- PHP ≥ 8.4
- Laravel 12 | 13
- [spatie/laravel-activitylog](https://github.com/spatie/laravel-activitylog) ≥ 5.0 (already logging your activities)
- Database table `activity_log` with Spatie v5’s schema (includes `attribute_changes` column)

### Optional (for export)

[](#optional-for-export)

FeaturePackageVersionExcel (XLSX)`maatwebsite/excel`^3.1PDF`barryvdh/laravel-dompdf`^2.0Add them when you need those formats:

```
composer require maatwebsite/excel barryvdh/laravel-dompdf
```

---

🚀 Installation
--------------

[](#-installation)

1. **Install the package**```
    composer require muhammadsadeeq/laravel-activitylog-ui
    ```
2. **(Optional) Publish resources**```
    # Config file (config/activitylog-ui.php)
    php artisan vendor:publish --provider="MuhammadSadeeq\ActivitylogUi\ActivitylogUiServiceProvider" --tag="activitylog-ui-config"

    # Blade views (if you want to customise)
    php artisan vendor:publish --provider="MuhammadSadeeq\ActivitylogUi\ActivitylogUiServiceProvider" --tag="activitylog-ui-views"

    # Public assets (logo, js, css)
    php artisan vendor:publish --provider="MuhammadSadeeq\ActivitylogUi\ActivitylogUiServiceProvider" --tag="activitylog-ui-assets"
    ```
3. **Run migrations**
    Ensure you have already run Spatie’s migrations so the `activity_log` table exists: ```
    php artisan vendor:publish --provider="Spatie\Activitylog\ActivitylogServiceProvider" --tag="activitylog-migrations"
    php artisan migrate
    ```
4. **Visit the UI**```
    /activitylog-ui   # default route prefix

    ```

---

⚙️ Configuration Overview
-------------------------

[](#️-configuration-overview)

A full configuration file is published to `config/activitylog-ui.php`. Below is a quick reference:

```
return [
    'route' => [
        'prefix' => 'activitylog-ui', // URL prefix
        'middleware' => null,         // Auto-detected or custom array
    ],

    'authorization' => [
        'enabled' => false,           // true => uses Gate / auth middleware
        'gate'    => 'viewActivityLogUi',
    ],

    'access' => [
        'allowed_users' => [],        // user email whitelist
        'allowed_roles' => [],        // role names (Spatie Permission, etc.)
    ],

    'features' => [
        'analytics' => true,
        'exports'   => true,
        'saved_views' => true,
    ],

    'exports' => [
        'enabled_formats' => ['csv', 'xlsx', 'pdf', 'json'],
        'max_records'     => 10000,
        'queue' => [
            'enabled'   => false,
            'threshold' => 1000,
            'queue_name'=> 'exports',
        ],
    ],
];
```

Refer to the inline comments in the file for every available option.

---

🔐 Authorization &amp; Access Control
------------------------------------

[](#-authorization--access-control)

- **Gate:** `viewActivityLogUi` is auto-registered (see `ActivitylogUiServiceProvider`). You may define it in your own code or rely on the package’s default email/role checks.
- **Toggle authentication:** Set `authorization.enabled` to `true` to require login + gate.
- **Granular lists:** `access.allowed_users` and `access.allowed_roles` let you open the UI to a subset of users—regardless of the gate.

---

📤 Exports
---------

[](#-exports)

- **CSV &amp; JSON** work out-of-the-box.
- **Excel (XLSX)** requires `maatwebsite/excel` – otherwise we gracefully fall back to CSV.
- **PDF** requires `barryvdh/laravel-dompdf` – otherwise we fall back to JSON.
- Large exports can be **queued**; enable `exports.queue.enabled`.

---

📈 Analytics Dashboard
---------------------

[](#-analytics-dashboard)

Enable/disable with `features.analytics`. Caches stats for `analytics.cache_duration` seconds (default 1 h).

---

🤝 Contributing
--------------

[](#-contributing)

PRs and issues are welcome!

---

📝 License
---------

[](#-license)

The MIT License (MIT). See `LICENSE` for details.

[![Latest Version on Packagist](https://camo.githubusercontent.com/f65aa652b71b75b6b1c86ce6bbc8917715987e24bbf08d327e214dd9cef67a85/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d7568616d6d61647361646565712f6c61726176656c2d61637469766974796c6f672d75692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/muhammadsadeeq/laravel-activitylog-ui)[![Total Downloads](https://camo.githubusercontent.com/7d1f5f6c6aea19144cd33f436c84ebdb073a4dc4cde9955ec8d70a488268cc1f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d7568616d6d61647361646565712f6c61726176656c2d61637469766974796c6f672d75692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/muhammadsadeeq/laravel-activitylog-ui)

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance75

Regular maintenance activity

Popularity44

Moderate usage in the ecosystem

Community16

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 82.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~45 days

Recently: every ~60 days

Total

7

Last Release

136d ago

Major Versions

v1.3.1 → v2.0.02026-04-02

PHP version history (2 changes)v1.0.0PHP ^8.1

v2.0.0PHP ^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/9774fe044d720e88137196e174a49d51e76a131ec9432550eab1bdcc3bc48363?d=identicon)[MuhammadSadeeq](/maintainers/MuhammadSadeeq)

---

Top Contributors

[![MuhammadSadeeq](https://avatars.githubusercontent.com/u/54463147?v=4)](https://github.com/MuhammadSadeeq "MuhammadSadeeq (19 commits)")[![Khant-Nyar](https://avatars.githubusercontent.com/u/61083917?v=4)](https://github.com/Khant-Nyar "Khant-Nyar (2 commits)")[![jeff1326](https://avatars.githubusercontent.com/u/12941529?v=4)](https://github.com/jeff1326 "jeff1326 (1 commits)")[![keatliang2005](https://avatars.githubusercontent.com/u/473990?v=4)](https://github.com/keatliang2005 "keatliang2005 (1 commits)")

---

Tags

spatielaravelpdfloggingmonitoringuiexportexcelcsvlaravel-packageAudittailwindtimelinedashboardanalyticschartjsactivity-logalpinejsaudit-logactivityloglaravel-activitylog

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/muhammadsadeeq-laravel-activitylog-ui/health.svg)

```
[![Health](https://phpackages.com/badges/muhammadsadeeq-laravel-activitylog-ui/health.svg)](https://phpackages.com/packages/muhammadsadeeq-laravel-activitylog-ui)
```

###  Alternatives

[spatie/laravel-health

Monitor the health of a Laravel application

88212.7M188](/packages/spatie-laravel-health)[mradder/filament-logger

Audit logging, activity tracking, exports, alerts, and dashboards for Filament admin panels.

2324.4k1](/packages/mradder-filament-logger)[alizharb/filament-activity-log

A powerful, feature-rich activity logging solution for FilamentPHP v4 &amp; v5 with timeline views, dashboard widgets, and revert actions.

2989.8k3](/packages/alizharb-filament-activity-log)[anousss007/vigilance

A driver-agnostic control center for Laravel queues, jobs, commands and the scheduler. Monitor what ran (with parameters), see failures, and dispatch jobs or run artisan commands manually from a self-contained dashboard.

1939.9k](/packages/anousss007-vigilance)[romalytar/yammi-audit-log-laravel

Universal change history and audit log for Laravel. Tracks who changed what and when across Eloquent models, with rich actor attribution (user, job, command, scheduler), field-level diffs, human-readable relationship labels and a timeline dashboard.

631.6k](/packages/romalytar-yammi-audit-log-laravel)[noxoua/filament-activity-log

A Laravel package that simplifies activity logging in the Filament admin panel, with support for logging create, update, delete, and restore actions. It integrates with the 'spatie/laravel-activitylog' package and includes a modernized activity log viewing page.

7255.1k](/packages/noxoua-filament-activity-log)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
