Ubisam-MobileGit/docs/decisions/001-android-application-baseline.md

ADR-001: Android application baseline

Status

Accepted — 2026-08-25

Context

TASK-001 requires a final application ID and minimum supported Android version before the project can be bootstrapped. The product owner approved the proposed values on 2026-08-25.

Decision

• Use com.ubisam.ubgitea as the application ID and Kotlin namespace.
• Support Android 9 (API 28) and later.
• Start with one Android application module using Kotlin, Jetpack Compose, and Material 3.
• Compile and target Android API 36, using JDK 17.

Alternatives considered

• The initially proposed me.ubisampaju.ubgitea identifier was not selected; the product owner explicitly chose com.ubisam.ubgitea.
• Supporting Android versions earlier than Android 9 was not selected because it increases compatibility and security maintenance for no established product requirement.
• A multi-module bootstrap was deferred until build-time or ownership boundaries justify it.

Consequences

• The HTTPS App Link Digital Asset Links file must eventually identify com.ubisam.ubgitea and the production signing certificate.
• Changing the application ID after distribution would create a distinct Android application, so future changes require product-owner approval.