kimai-plugin-heatmap/README.md

Kimai Heatmap Plugin

A GitHub-style activity heatmap for your Kimai dashboard. See where your time went at a glance.

Features

• Calendar heatmap showing daily tracked hours over the past year
• Project filter dropdown
• Click any day to jump to that day's timesheet
• Streak counter and summary stats (total hours, daily average, busiest day)
• Weekend visual distinction
• Respects your configured start-of-week preference
• Works with light and dark themes
• Responsive — scrollable on small screens, resizes with the browser

Installation

Copy the plugin into your Kimai var/plugins/ directory:

cd /path/to/kimai
git clone https://github.com/toph/kimai-heatmap.git var/plugins/KimaiHeatmapBundle
bin/console kimai:reload

Development

Requires Nix:

nix develop
process-compose up  # starts MariaDB + Kimai
npm test            # run JS tests

License

MIT