Graphhopper Maps with GPS Navigation

May 22, 2026 ยท View on GitHub

This Android app is a capacitor-wrapper for the native-navigation branch of GraphHopper Maps. Since version 3.x native navigation is used instead of in-browser navigation.

Install

We provide automatically generated build artifacts for every commit. You can find them in the actions tab.

Otherwise, you can download stable versions on F-Droid:

Get it on F-Droid

Development

Clone the repository

git clone --recursive https://github.com/boldtrn/graphhopper-maps-capacitor.git

Build the project

Make sure you have all the requirements for Capacitor.

./build_local.sh

Run the project

Note: you can either run the app straight away or open it in Android Studio. You can generate an APK in Android Studio, or debug the app etc.

Open Android App on Device

npx cap run android

Open in Android Studio

npx cap open android

Release Update Version

  1. Make sure to pull the latest version of the submodule "graphhopper-maps". (Automated build tools should do this anyway)
  2. Open android/app/build.gradle and increment the versionCode and set the versionName. Note that the tag name must be v<versionName> because in F-Droid they require this in the metadata/com.graphhopper.maps.yml -> (AutoUpdateMode: Version v%v).
  3. Write changelog in fastlane/metadata/android/en-US/changelogs/<versionCode>.txt
  4. Commit
  5. Tag commit
    1. Create a tag using git tag -a v1.0.1
    2. Push tags git push origin --tags