Skip to content
Håkon Olav Torvik edited this page Oct 24, 2026 · 2 revisions

Relay

Relay is a personal Android app that rivals and replaces the stock Android Clock: alarms, timers that relay (chain), a stopwatch, a world clock and home-screen widgets. It exists because the stock app can't chain timers, can't schedule anything but a ringing alarm, and can't run one timer twice at once.

Everything is local (no account, no sync), built with Kotlin and Jetpack Compose, and an alarm must never fail to fire.

Request a feature or report a bug

Open an issue: https://github.com/Haakooto/Relay/issues/new/choose

Features and bugs are tracked as GitHub issues. Pick the bug report or feature request form.

Pages

  • Roadmap: what is planned, deferred, in progress or lacking, grouped by theme, with links to the issues
  • Feature Map: every feature with its status (Approved, WIP, Lacking, Planned, Deferred, Declined)
  • The design spec:
    • Design Spec: goals, stack and the core model (§01 to §03), and the contents of the whole spec
    • Panes Spec: alarms, timers and relays, stopwatch, clock, widgets, bedtime, calendar events, settings and automation (§04, §05, §07 to §12)
    • Relay Language: the relay language, its rules and safety limits (§06)
    • Firing Module: firing and reliability (§13)
    • Data Model: persistence (§14)
    • Visual Direction and Build Order: look, build order and open questions (§15 to §17)

In the repository

These stay in the repository because the build uses them or they change with the code:

  • docs/usage-guide.md and docs/usage-guide.nn.md: the user guide (English and Nynorsk), copied into the app
  • docs/device-tests.md: the on-device checklist per build
  • CHANGELOG.md: notes per release

Clone this wiki locally