The official mobile application for 5kmrun.bg — Bulgaria's free weekly 5 km run community. Built with Flutter, targeting Android and iOS.
5kmrun.bg organises free, timed 5 km runs every Saturday in parks across Bulgaria. The app lets participants:
- Log official Saturday runs by scanning the event barcode at the finish line
- Add Strava selfie-runs — any GPS-tracked 5 km outdoor run recorded in Strava
- Track progress with weekly charts, personal bests, and run history
- Browse events — upcoming and past run locations
- View any profile in read-only mode using Login with ID (try IDs:
13731,2,18880)
| Path | Contents |
|---|---|
fivekmrun_app_flutter/ |
Flutter app source — see its README for setup instructions |
website-resources/ |
Static assets related to the web presence |
PRs are very welcome! A few guidelines:
- Open an issue first for any significant feature so we can align on direction
- Test on both platforms (iOS and Android) before opening a PR — reach out on Discord if you need help with a platform you don't have access to
- Aim for parity between iOS and Android; platform-specific exceptions are acceptable where no alternative exists
See the Flutter app README for local setup, secrets configuration, and build commands.
Questions, ideas, support → Discord
