The next version of Mapeo Mobile
Clone repository
git clone https://github.com/digidem/comapeo-mobile.git
Set up the development environment
Install Node, ideally through a proper node version manager such as nvm, fnm, asdf, or mise
Follow the React Native instructions for setting up the development environment: https://reactnative.dev/docs/environment-setup
Note that Java 17 is the minimum version required for this project.
When setting up the Android-specific tooling, you will also need to install the Android NDK. This can be installed using Android Studio by going to the SDK Tools
tab in the SDK Manager
. This project uses NDK 25.1.8937393.
Copy the .env.template
file to a file called .env
. Replace any placeholder <replace_me>
values with the relevant ones:
MAPBOX_ACCESS_TOKEN
: a Mapbox access token. If you do not have access to a Mapbox account, reach out to the maintainers about getting access to an access token.
MAPBOX_DOWNLOAD_TOKEN
: a Mapbox secret token. This is unfortunately required to install the necessary Mapbox Android SDK components used by @rnmapbox/maps@10
when building the app (more info here). If you do not have access to a Mapbox account, reach out to the maintainers about getting access to a secret token.
COMAPEO_METRICS_URL
: URL pointing to a hosted CoMapeo metrics server. Reach out to the maintainers about getting access to this credential.
COMAPEO_METRICS_API_KEY
: API key needed for accessing a CoMapeo metrics server. Reach out to the maintainers about getting access to this credential.
Run the app locally
Install dependencies
This project requires the following system dependencies. Make sure they are available on your PATH
.
curl
tar
Install NPM-based project dependencies
npm install
Generate the native code
app.json
or app.config.js
, or install/update any dependencies that provide native code, you should run the following command to make sure the project is up-to-date:npx expo prebuild
If you have made any manual changes to the generated directories (e.g. android/
or ios/
), you may need to specify the --clean
flag with the command.
Start the Metro bundler process
npm start
Leave this running in a separate terminal window.
Build and run the app (Android)
For this project, using a physical device is more convenient and reliable to work with. It is recommended that you follow React Native's setup instructions for running an app on a device.
Run the following command to build the backend and then build and run the Android app:
npm run android
If you do not need to rebuild the backend on subsequent runs (e.g. no changes in the src/backend/
directory), you can use the following command instead:
npm run android-no-backend-rebuild
This project is tested with BrowserStack.