mdamin1129 / laravel-feature-heatmap

v1.0.0 2026-09-14 17:51 UTC

Requires

• php: ^8.1
• composer-plugin-api: ^2.0
• illuminate/database: ^10.0|^11.0|^12.0|^13.0
• illuminate/support: ^10.0|^11.0|^12.0|^13.0

MIT

• Amin

Published on Packagist.org on 2026-09-14 17:52 UTC

README

A Powerful Laravel Feature Usage Tracking & Heatmap Dashboard Package by Amin
Track controllers, routes, users, and feature adoption in your Laravel application with zero configuration.

✨ Features

• ⚡ Zero-Setup Global Tracking — Automatically registers middleware to track all application routes with zero manual configuration in web.php or Kernel.php
• 🔥 Interactive Heatmap Dashboard — Visualise Feature × Date and Feature × User usage patterns with interactive charts
• 👤 User-Wise Tracking & Drill-Down — Track individual user activity across modules and features with detailed modal drill-downs
• 📥 CSV Activity Reports — Export per-user feature interaction reports directly from the dashboard with a single click
• 💤 Unused Feature Discovery — Detect features dormant for 30+ days to clean up technical debt and refactor safely
• ⚡ Non-Blocking Queue Logger — Dispatches logging jobs asynchronously using Laravel queues to maintain ultra-fast HTTP responses
• 🧹 Daily Summary & Auto-Pruning — Aggregates high-volume raw logs into lightweight daily summary records to keep your database fast and lean
• ⚙️ Highly Configurable — Easily exclude debug/admin routes, configure authorization gates, user models, and table schema mappings

📋 What It Tracks

The package focuses on code-level feature adoption — identifying exactly which controllers, methods, and routes are used by whom.

Tracked Data	Source / Description
Controller & Action	e.g. App\Http\Controllers\OrderController@store
Route Name	e.g. orders.store
HTTP Method	GET, POST, PUT, DELETE, etc.
Request URI	Full endpoint URI path
User Identity	Authenticated user_id, resolved with User Name & Email
Timestamps	High-precision hit timestamps & daily usage frequency

📦 Installation

composer require mdamin1129/laravel-feature-heatmap

Publish Configuration (Optional)

php artisan vendor:publish --tag=feature-heatmap-config

Run Migrations

php artisan migrate

This creates two optimized database tables:

• feature_usage_logs: Stores raw per-request interaction logs.
• feature_usage_summaries: Stores aggregated daily usage statistics for fast heatmap rendering.

🚀 Usage

Automatic Global Tracking (Zero Setup)

By default, the package automatically registers and attaches the tracking middleware to all web and api route groups inside the FeatureHeatmapServiceProvider.

No manual edits to web.php, api.php, or bootstrap/app.php are required!

📄 License

The MIT License (MIT). Please see License File for more information.