A Chrome extension that draws your self-hosted Dreeve heatmap — every route you've recorded, plus your explorer tiles — directly on top of the route-planning and mapping tools you already use.
Plan your next ride on gpx.studio and instantly see which roads you've already covered. Spot unexplored tiles. Check your own tracks while mapping in the OpenStreetMap iD editor.
- 🔥 Route heatmap — draws all your Dreeve activity polylines on the page's map (on MapLibre / Mapbox hosts, routes appear from zoom 11; at overview zoom you see tiles)
- 🟧 Explorer tiles — visited, cluster, max-cluster and max-square tiles, matching the Dreeve heatmap
- 🎛️ Independent layers — toggle Show routes and Show tiles separately (both on by default)
- 🚴 Sport filters —
Ride,Walk,Water,Winter; applies to routes and tiles. Virtual activities (VirtualRide,VirtualRun) are always excluded - 🎨 Styling — shared colour and opacity for routes and tiles, plus route line width
- 🔎 Activity popups — click a route to see activity details and links back to Dreeve
- ⚡ Fast — cached payloads with
ETagrevalidation, route parsing in a Web Worker, viewport-filtered and zoom-simplified layers, and style changes that don't re-fetch geometry - 🌐 Per-site control — built-in hosts are on by default; turn on Enable on this site in the popup to use any other page with a MapLibre or Mapbox map
- 🏠 Your data, your server — points at any Dreeve endpoint you choose; nothing goes through a third party
| Site | Map engine | Routes | Explorer tiles |
|---|---|---|---|
| gpx.studio | MapLibre GL JS | ✅ | ✅ |
| Wanderstories Studio | Mapbox GL JS | ✅ | ✅ |
| OpenStreetMap iD editor | iD (SVG) | ✅ | — |
| Any other http(s) page with a MapLibre / Mapbox map (opt in) | MapLibre / Mapbox GL JS | ✅ | ✅ |
| Feature | Minimum Dreeve | Endpoint |
|---|---|---|
| Routes | v5.3.0 | /api/internal/heatmap/routes |
| Explorer tiles | v5.6.0 | /api/internal/heatmap/tiles |
You only configure the routes URL; the tiles URL is derived from it automatically. Both endpoints return the full dataset (no bounds or zoom filtering on the server yet), so the extension caches the responses and filters in the browser.
Note
Older Dreeve endpoints (/api/heatmap/routes.json and /api/fragment/data/heatmap/routes) are no longer supported.
The extension is not on the Chrome Web Store yet. Install it unpacked:
- Download or clone this repository:
git clone https://github.com/Luen/dreeve-heatmap-plugin.git
- Open
chrome://extensionsand enable Developer mode (top right). - Click Load unpacked and select the repository folder.
- Pin the extension so the popup is one click away.
Works in Chrome and other Chromium-based browsers (Edge, Brave, Arc, …).
- Open gpx.studio or Wanderstories Studio.
- Open the extension popup and enter your Dreeve routes endpoint, for example:
http://localhost:8000/api/internal/heatmap/routes - Choose Show routes / Show tiles, colour, opacity, width and sport filters.
- Click Enable. While enabled, popup changes apply immediately.
- Click Disable to remove the overlay.
- Open the iD editor, e.g.
https://www.openstreetmap.org/edit#map=16/48.82523/-125.13630. - Open the extension popup, set your endpoint and click Enable. (Show tiles is disabled here — iD supports routes only. Your tile preference for other sites is kept.)
- Press B for Background settings and scroll to Overlays.
- Toggle Dreeve Routes on or off.
- Click Disable in the popup to unload the data and remove the overlay entry.
- Open the page and wait for its map to load.
- In the popup, tick Enable on this site. The popup checks the page for a map and warns you if it can't find one.
- Click Enable.
Once a site is enabled, the overlay comes back automatically when you reload or revisit it, just like on the built-in hosts. Untick Enable on this site to stop using the extension on a host, including the built-in ones.
| Setting | Example |
|---|---|
| Colour | #ff4500 (default), #00bcd4 |
| Opacity | 0.2 |
| Width | 3 |
| Sport filter | Ride (includes road, gravel, MTB and e-bike) |
Settings save automatically to chrome.storage.sync and follow you across browsers where you're signed in.
Popup / options ──► chrome.storage.sync
│
▼
Background service worker ──fetch──► Your Dreeve server
(cache + ETag) /api/internal/heatmap/routes
│ /api/internal/heatmap/tiles
▼
Content script ──► Web Worker (normalize routes)
│
▼
Page bridge ──► MapLibre / Mapbox GL layers, or iD SVG overlay
- Fetching happens in the background service worker, so page-level CORS rules don't get in the way.
- Caching: route and tile payloads are kept in memory and
chrome.storage.sessionfor about 20 minutes, revalidated withETag/If-None-Matchwhen your server supports it. A fresh Enable after Disable always refetches. - Rendering: style-only changes (colour, opacity, width) update the map without re-fetching or re-parsing geometry.
- OpenStreetMap:
/editembeds iD in an/idiframe; the extension hooks that iframe at boot and messages it from the popup.
The routes endpoint returns an array of activities with coordinates as [lat, lng] pairs:
[
{
"id": "activity-123",
"coordinates": [
[-19.37, 146.64],
[-19.38, 146.65]
]
}
]| Permission | Why |
|---|---|
storage |
Save your endpoint, layer toggles, style and filters |
tabs, scripting, webNavigation |
Inject the overlay into supported map sites and the iD iframe |
http://*/*, https://*/* |
Reach your self-hosted Dreeve server, wherever it lives |
| Symptom | Fix |
|---|---|
| Overlay doesn't appear | Click Reload on the extension in chrome://extensions, then refresh the map tab. |
| Nothing on the iD editor | Reload /edit after installing or updating so the editor boot hook can run. |
| Popup shows a fetch error | Check the endpoint is reachable from your browser's network (VPN, LAN, firewall). |
| Endpoint returns HTML instead of JSON | Make sure you're on Dreeve v5.3.0+ and using /api/internal/heatmap/routes. |
| Routes work but tiles fail | Tiles need Dreeve v5.6.0+ with /api/internal/heatmap/tiles reachable. |
| Self-signed HTTPS certificate | Open the endpoint in a normal tab first and accept the certificate so Chrome trusts it. |
Requires Node.js 20+. Tooling is for formatting and linting only — there is no build step, so the repository folder is the unpacked extension.
npm install
npm run format # Prettier (write)
npm run lint # ESLint
npm run check # format check + lintBranches: open feature and fix PRs against dev; main is production. See AGENTS.md for conventions and the release process.
The social preview image is generated from .github/assets/social-preview.html — instructions are in the file header.
- Dreeve — self-hosted activity statistics and heatmaps
- gpx.studio — online GPX route planner and editor
- OpenStreetMap iD — the web editor for OpenStreetMap

