Download the PHP package farukcoder/laravel-feature-heatmap without Composer
On this page you can find all versions of the php package farukcoder/laravel-feature-heatmap. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download farukcoder/laravel-feature-heatmap
More information about farukcoder/laravel-feature-heatmap
Files in farukcoder/laravel-feature-heatmap
Package laravel-feature-heatmap
Short Description Track which controllers/routes/features are used by which users, and visualize it as a heatmap.
License MIT
Informations about the package laravel-feature-heatmap
๐ฅ Laravel Feature Heatmap
A Powerful Laravel Feature Usage Tracking & Heatmap Dashboard Package by Farukcoder
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.phporKernel.php - ๐ฅ Interactive Heatmap Dashboard โ Visualise Feature ร Date and Feature ร User usage patterns with interactive ApexCharts
- ๐ค 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
๐ฅ๏ธ CLI Output on Installation
Note: The package auto-discovers the service provider and middleware. No manual provider registration is needed for Laravel 10+.
Publish Configuration (Optional)
Run Migrations
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
Step 1 โ 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 Kernel.php are required!
Optional Manual Mode: If you prefer manual middleware control, set
'auto_track' => falseinconfig/feature-heatmap.phporFEATURE_HEATMAP_AUTO_TRACK=falsein.env. You can then apply the named middlewaretrack.featureto specific routes or groups:
Step 2 โ Schedule Daily Aggregation & Pruning
Raw request logs build up quickly on high-traffic sites. Schedule the built-in Artisan command to aggregate raw logs daily and prune old entries.
Laravel 10 (app/Console/Kernel.php):
Laravel 11+ (routes/console.php):
Step 3 โ Access the Heatmap Dashboard
Navigate to the dashboard in your web browser:
๐ค User-Wise Tracking & CSV Export
The dashboard includes a dedicated User-Wise Tracking Table:
- User Summary Table: Lists all active users, total interaction count, distinct features used, and last active date.
- Module Drill-Down: Click on any user row to launch an interactive breakdown showing exact features accessed by that specific user across dates.
- CSV Export: Click the Download CSV Report button on any user row to generate a complete report file (
heatmap-report-{username}-{date}.csv).
โ๏ธ Configuration
After publishing, edit config/feature-heatmap.php:
Environment Variables
Add these to your .env file to customize behavior:
๐ ๏ธ Artisan Commands
| Command | Description |
|---|---|
php artisan feature-heatmap:aggregate |
Aggregates raw logs into daily summary statistics |
php artisan feature-heatmap:aggregate --prune |
Aggregates raw logs and deletes entries older than raw_log_retention_days |
๐ API Endpoints
The dashboard exposes internal JSON & CSV endpoints under the configured route prefix (/feature-heatmap):
| Method | URI | Description |
|---|---|---|
GET |
/feature-heatmap |
Renders the HTML Dashboard UI |
GET |
/feature-heatmap/data |
Returns global heatmap data for charts |
GET |
/feature-heatmap/users |
Returns user summary table data |
GET |
/feature-heatmap/users/{userId} |
Returns module-wise heatmap detail for a user |
GET |
/feature-heatmap/users/{userId}/report |
Streams downloadable CSV activity report for a user |
๐ง Laravel & PHP Compatibility
| Laravel Version | PHP Version | Status |
|---|---|---|
| 10.x | 8.1+ | โ Supported |
| 11.x | 8.2+ | โ Supported |
| 12.x | 8.2+ | โ Supported |
| 13.x | 8.3+ | โ Supported |
๐ค Contributing
Contributions are welcome! Please feel free to submit a Pull Request:
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
๐ Changelog
v1.0.0 (2026-07-23)
- ๐ Initial release of
farukcoder/laravel-feature-heatmap - โก Zero-setup automatic global route tracking
- ๐ฅ Interactive Feature ร Date and Feature ร User ApexCharts heatmaps
- ๐ค User-wise tracking table with modal drill-downs
- ๐ฅ Streamed CSV user activity report exporter
- ๐งน Automated log aggregation and pruning Artisan command
- ๐ค Unused feature detection engine
๐ก๏ธ Security
If you discover any security-related issues, please report them directly to the author instead of using the public issue tracker.
๐ License
The MIT License (MIT). Please see LICENSE for more information.
๐จโ๐ป Author
Md. Omar Faruk โ Full Stack Software Engineer
- GitHub: @farukcoder
Made with โค๏ธ by Farukcoder
All versions of laravel-feature-heatmap with dependencies
composer-plugin-api Version ^2.0
illuminate/support Version ^10.0|^11.0|^12.0|^13.0
illuminate/database Version ^10.0|^11.0|^12.0|^13.0