#Fjord for Android

Fjord for Android is the Android counterpart to the iOS app: a universal phone and tablet client for self-hosted Forgejo, built to reach the same feature set against the same API contract.

#Requirements

#How it is built

The Android app shares Fjord’s design goals and its API discipline, on a native Android stack:

• Kotlin with Jetpack Compose and Material 3.
• Single-Activity app with Navigation Compose.
• ViewModel plus StateFlow, dependency injection with Hilt.
• Ktor and kotlinx.serialization for networking.
• A generated :forgejokit module built from the same shared forgejo-api-contract OpenAPI spec the iOS client uses, so app code never builds requests by hand. Both apps move in lockstep when the contract changes.

#Building from source

You need a JDK (17 or later) and the Android SDK. With Android Studio installed:

JAVA_HOME="/Applications/Android Studio.app/Contents/jbr/Contents/Home" \
ANDROID_HOME="$HOME/Library/Android/sdk" \
./gradlew assembleDebug testDebugUnitTest

Or open the project in Android Studio and run the app configuration. The repository’s docs/parity-plan.md tracks the roadmap and what has shipped.

#Signing in

Connecting works the same way as on iOS: a Fjord Account for the hosted platform, or a personal access token for any Forgejo instance by hostname. Sign-in is evolving with the app; see Signing in for the credential model and token scopes.