# 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.