An android Client for the Wanderer Balade Server
- Kotlin 93.3%
- HTML 4.5%
- DM 1.6%
- Python 0.6%
- Added Printscreen1.png and Printscreen1_ratio.png - Added Printscreen2.png and Printscreen2_ratio.png - Added Printscreen3.png and Printscreen3_ratio.png - Added Printscreen4.png and Printscreen4_ratio.png - Added Tablet1.png and Tablet2.png These images are essential for the updated logo presentation and branding materials. |
||
|---|---|---|
| apk | ||
| app | ||
| exports | ||
| gradle/wrapper | ||
| logo | ||
| scripts | ||
| .gitignore | ||
| build.gradle.kts | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| README.md | ||
| settings.gradle.kts | ||
| temp_api_reference.html | ||
Balades
Android client foundation for a self-hosted Wanderer server.
Current scope
This first version implements:
- A polished first-launch landing and connection screen built with Jetpack Compose and Material 3
- Form validation for server URL, username/email, and password
- Local persistence of the server URL with DataStore
- A simulated successful connection flow
- Navigation to a placeholder home screen after pressing
Connect
Real Wanderer authentication is intentionally not wired yet. The login view model includes a marked TODO where the API call and token/session persistence should be added once the Wanderer API contract is available.
Project structure
app/src/main/java/com/wanderermobile/app/data- DataStore-backed local persistence
app/src/main/java/com/wanderermobile/app/domain- Form validation logic
app/src/main/java/com/wanderermobile/app/ui- Compose screens, navigation, theme, and view models
Build
Prerequisites:
- Android Studio with the Android SDK installed
- JDK 17
Open the repository in Android Studio and run the app configuration. The Gradle wrapper is included, so Android Studio should sync the project directly.
Suggested next steps
- Replace the simulated connect delay with a real Wanderer authentication request.
- Store session/auth data separately from the server URL.
- Add a repository layer for trails, maps, and upload APIs.
- Introduce location recording and media capture flows behind the placeholder home screen.