README.md

Ladefuchs Mobile

Written in	Available at	Licensed with

Ladefuchs is an open-source app that compares charging tariffs inside Germany depending on the charging-station you are currently standing at. Ladefuchs is a non-profit application and organisation that aims for making electric mobility more accessible to a broader userbase by adopting well-known patterns.

Ladefuchs is available on

• Apple iOS App Store
• Google Android Play Store
• F-Droid - Metadata at https://gitlab.com/fdroid/fdroiddata/-/blob/master/metadata/app.ladefuchs.android.yml

How to run and execute locally

Important

In order to run and use this application locally you need request a valid API_TOKEN.

Setup your local toolchain.

// Install necessary tooling
npm install
npm run eula

// Create / Update local .env file to supply API_TOKEN
API_TOKEN=12xxxxxxxxxxx

Run the app

iOS	Android
npm run ios or npx expo run:ios	npm run android or npx expo run:android

Android: You need to have Android Studio installed and configure the following environment variables:

# export JAVA_HOME=/Library/Java/JavaVirtualMachines/openjdk-17.jdk/Contents/Home
# export ANDROID_HOME=$HOME/Library/Android/sdk

iOS: You need a Mac for iOS developement with Xcode installed.

How to build the app

npm run build

Android APK

npx expo prebuild --clean
cd android
./gradlew assembleRelease

Packages

• Expo App Router

• React Navigation

• React Native UI

• React Native Picker

F-droid packaging instructions

• [fastlane/metadata/android/] should be up to date (especially /changelogs/ in /de-DE/ and /en-US/)
• Create a tag with a pattern "X.Y.Z"
• Check https://gitlab.com/fdroid/fdroiddata/-/blob/master/metadata/app.ladefuchs.android.yml which should automatically update
• If any problems, open a GitLab Merge Request (see https://gitlab.com/fdroid/fdroiddata/-/merge_requests/15604 for example)
• The automatic build procedure can take a while, check https://monitor.f-droid.org/builds/build