ntp-android/project-docs/decisions/0001-native-android-local-first.md
WayfinderAK bfb027fcd2
Some checks failed
android-apk / debug-apk (push) Has been cancelled
Initialize Android NTP app framework
2026-07-09 15:44:22 -08:00

622 B

ADR 0001: Native Android local-first app

Decision

Build v1 as a native Kotlin Android app using Jetpack Compose, Room, and direct UDP NTP probes.

Rationale

  • The app needs low-friction device-side network diagnostics.
  • No backend is required for saved servers, profiles, local history, comparison, or export.
  • Local-only storage avoids telemetry and customer data exposure.

Consequences

  • APKs can be built locally or in Gitea Actions.
  • Gitea runners must have Android build tooling or install it during the workflow.
  • Release builds require signing keys managed through secrets, not committed files.