About this project

fablab-tools hosts free, open-source apps and utilities from FabLab 503, built with Claude Code and published from GitHub Actions. Its main project is VeloTrack. VeloTrack — offline cycling map and ride recorder (Android) - A 3D course-up vector map that works with GPS only, so no data connection is needed while riding. Map areas can be downloaded in the app for a chosen radius (10 km, 100 km, 1000 km, a country such as France, or the whole world) straight from the Protomaps planet file. - Ride recording of any length, with automatic start when you set off and automatic pause when you stop, GPX export and lifetime statistics. - Home, Work and favourite places with straight-line guidance, plus the name of the street or park you are currently on. - A minimal riding mode displayed above 5 km/h, a day/night theme switched by sunrise and sunset, and a dark OLED-friendly style. - No accounts, no analytics and no Google Play Services; the README states it is built for battery life. Install: download `velotrack-latest.apk` from the Releases page (tag `velotrack-latest`) onto the phone and open it. A fuller guide, screenshots, settings and build notes live in velotrack/README.md. Repository layout - `velotrack/` — the Android app (Kotlin), its tools and third-party notices. - `.github/workflows/` — CI that builds, tests, signs and publishes the APK on every push, with map extraction on demand. - `docs/superpowers/` — design briefs and plans written before each feature round. - `assets/icons3d/` — a CC0 3D icon library (3dicons.co) used for illustrations. - `skills/` — the Claude Code skills describing how the project is built and tested. Contributing: open an issue or a pull request. Builds run on GitHub Actions only, so Android Studio is not required — push a branch and read the workflow log. Pull requests from forks produce a debug-signed APK because the release signing key is a repository secret. Licence: MIT (see LICENSE). VeloTrack bundles third-party components under their own licences, listed in velotrack/THIRD_PARTY.md. Map data is © OpenStreetMap contributors (ODbL).