40 lines
996 B
Markdown
40 lines
996 B
Markdown
# Kimai Heatmap Plugin
|
|
|
|
A GitHub-style activity heatmap for your [Kimai](https://www.kimai.org/) 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:
|
|
|
|
```bash
|
|
cd /path/to/kimai
|
|
git clone https://github.com/toph/kimai-heatmap.git var/plugins/KimaiHeatmapBundle
|
|
bin/console kimai:reload
|
|
```
|
|
|
|
## Development
|
|
|
|
Requires [Nix](https://nixos.org/):
|
|
|
|
```bash
|
|
nix develop
|
|
process-compose up # starts MariaDB + Kimai
|
|
npm test # run JS tests
|
|
```
|
|
|
|
## License
|
|
|
|
MIT
|