BikeBuddy 🧭

BikeBuddy – Your ride, your routes, your memories. Upload GPX tours from any ride (cycling or motorcycling), visualize them as heatmaps, and attach photos.

Quickstart

All helper scripts run through a single entry point, ./buddy.sh <group> <command> (./buddy.sh --help lists everything):

./buddy.sh development setup       # one-time: install tools + config templates (Docker must be running)
./buddy.sh development start-all   # start the full local stack → http://localhost:4280

Documentation

Full docs live in docs/, organised by Diátaxis:

• Tutorial — Getting started
• How-to — User guide · Developer guide (local dev, auth/tokens, deploy)
• Reference — Architecture · Configuration
• Explanation — Design decisions · Cost report

Infrastructure details: Infrastructure how-to. Contributor conventions: CLAUDE.md.

Technology map