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.

v1.3.0(2mo ago)17510.1k↓27.2%7MITBladePHP ^8.1

Since Jul 4Pushed 1mo 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 1mo ago

READMEChangelog (6)Dependencies (8)Versions (5)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

Maintenance88

Actively maintained with recent releases

Popularity43

Moderate usage in the ecosystem

Community16

Small or concentrated contributor base

Maturity48

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 ~81 days

Total

4

Last Release

73d ago

### 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

[alizharb/filament-activity-log

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

2326.6k](/packages/alizharb-filament-activity-log)[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.

7151.5k](/packages/noxoua-filament-activity-log)[mradder/filament-logger

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

141.1k](/packages/mradder-filament-logger)

PHPackages © 2026

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