Repository navigation
Feature Map
What is actually built, versus what is just planned. A ledger, not a roadmap, grouped by the build order in the design spec. For what comes next, see the Roadmap. The v0.5 ledger is in git history.
2026-10-25, rev 21 (calendar files and richer repeats approved, #33 #43) · 67 tracked items · chainlang: 54/54 tests passing
| Approved | WIP | Lacking | Planned | Deferred | Declined |
|---|---|---|---|---|---|
| 58 | 0 | 3 | 0 | 5 | 1 |
Status key
- ✓ Approved: built, tested, confirmed working on the device
- ◐ WIP: built, not yet verified (or partly built)
- ✕ Lacking: known gap, no fix yet
- Planned: designed, no code
- Deferred: pushed out past 1.0
- ✕ Declined: decided against
Build step 1. Confirmed on-device.
| Feature | Status | Note |
|---|---|---|
| Five-pane bottom navigation | ✓ Approved | Confirmed on-device: panes switch correctly. Still to check: pane stays put when changing language |
| Theme tokens: system / light / dark / AMOLED | ✓ Approved | Spec §15 palette. The first frame waits for settings, so a dark-theme user never sees a light flash |
| i18n: English + Norwegian | ✓ Approved | All strings in strings.xml with an nb translation |
| Per-app language | ✓ Approved | System LocaleManager API, so it also shows in system settings. Needs a device check |
| Settings: 24 h, first day of week, haptics, version | ✓ Approved | Stored in DataStore (relay_settings). Version comes from git |
| Room + migration test harness | ✓ Approved | Migrations confirmed in practice: every alpha installed over the last on-device (v1 to v5). The instrumented MigrationTest still needs an emulator to run |
| chainlang carried over | ✓ Approved | Moved to com.relay.chainlang, 30/30 tests passing. The v1.0 language changes (ref arithmetic, fractional range, step labels) come in step 4 |
| Separate install from v0.5 | ✓ Approved |
applicationId com.relay.app, so v0.5 keeps working alongside until you uninstall it |
Build step 2. Spec §04, §13. Confirmed on-device.
| Feature | Status | Note |
|---|---|---|
| Plain alarm: create / edit / delete / toggle | ✓ Approved | List sorted by next fire, with "rings in" and a set-for toast. New alarms open straight into the time picker |
| One-off (delete or disable after firing) and repeating (weekdays, end date / count) | ✓ Approved | One-off keeps its row until the ring is over, so snooze works, then deletes or switches off |
| Schedule exceptions: skip or retime dates, apply to several alarms | ✓ Approved | Accepted on-device without a dedicated test pass |
| Full-screen ringing over the lock screen | ✓ Approved | Confirmed on-device: wakes the screen and shows over the lock screen |
| Continuous looping audio, volume ramp, vibration | ✓ Approved | Looping and the volume ramp confirmed on-device. Vibration not confirmed yet (low priority) |
| Snooze with per-alarm length and max count | ✓ Approved | Snooze and dismiss confirmed on-device. Length now takes any number (1 to 240 min); max snoozes has None. Still to check: the limit, custom length |
| Upcoming-alarm notification with Dismiss now | ✓ Approved | Accepted on-device without a dedicated test pass |
| Late-fire notice | ✓ Approved | Accepted on-device without a dedicated test pass |
| Reschedule on boot, time change, time-zone change, update | ✓ Approved | Also on every app start, since a force-stop clears alarms silently. Covered by unit tests, including the fire-vs-restart race |
| Several things ringing at once, stacked | ✓ Approved | Stacked cards on the ringing screen, each dismissed on its own. Ring timeout (default 10 min) stops and notifies |
| Alarms after a reboot, before the first unlock | ✕ Lacking | Relay isn't direct-boot aware yet, so alarms are re-armed only after you unlock once. Needs device-protected storage for the schedule table |
Build step 3. Spec §05. Confirmed on-device.
| Feature | Status | Note |
|---|---|---|
| Persisted run engine, driven by exact alarms | ✓ Approved | One exact alarm (setAlarmClock) per run for the current step end; state in Room. Seamless steps advance from the scheduled end, so late alarms don't stretch a relay. 11 unit tests |
| Timer: Start (unsaved, with label) / Save (library) | ✓ Approved | Start keeps the label on an unsaved run; Save needs a unique, script-safe label. Labels on unsaved runs are free text |
| Parallel runs of one definition | ✓ Approved | Each start is its own run with its own card and notification |
| Quick-start buttons (4, configurable) | ✓ Approved | v1.1: moved out of the + menu to small buttons left of the +, one tap. Durations editable in Settings |
| Run controls and Stop / Restart / +1 min at completion | ✓ Approved | Pause, resume, reset (to the start, paused), +1 min, stop. At the end: Stop / Restart / +1 min through the ringing screen |
| A run left waiting at a boundary or the end, after a reboot | ✕ Lacking | Shows on the Timers pane and in its notification, but doesn't ring again |
| Library with headers and drag-to-reorder | ✓ Approved | Drag-to-reorder and header up/down reused from v0.5 |
| Draft editing (definition changes only on Save) | ✓ Approved | Editors work on a copy; Save writes it. Start from an editor runs the draft |
Build step 4. Spec §05, §06. Confirmed on-device.
| Feature | Status | Note |
|---|---|---|
| Relay definitions, transition mode, seamless tone | ✓ Approved | Transition mode, seamless cue (previewed when picked), default sound and vibration |
Ref arithmetic (Test2 - 2), fractional range, step labels |
✓ Approved | All in chainlang, 19 new tests. Steps that come out at 0 or less are rejected |
| Plan check across references (size and depth) | ✓ Approved | PlanBuilder counts and depth-checks the expanded plan, and fails safely on a cycle. 10 unit tests |
| Per-step sound / transition override | ✓ Approved | Tap a step in the live preview. Provisional UI, per spec |
| Editor: auto-close, auto-indent, autocomplete, live preview, syntax help | ✓ Approved | Auto-close ( and ", type-over, auto-indent, empty-pair delete (13 unit tests), suggestion chips for names and functions, highlighting, syntax help |
| Renaming updates relays that use the old label | ✓ Approved | Token-aware: quoted labels are left alone. Deleting asks first and names the relays that would break |
| Error messages from the relay language in Norwegian | ✕ Lacking | chainlang messages are English only; the module has no Android strings |
Build step 5. Spec §04. Confirmed on-device.
| Feature | Status | Note |
|---|---|---|
| Alarm fires a Timer / Relay (library or inline) | ✓ Approved | "When it goes off": Ring, or start a timer or relay, saved or built inline. Starts quietly at the alarm time; if it can't start (deleted, broken), it rings and says why. Room v6 |
| Alarm starts a Stopwatch | ✓ Approved | Name, start offset (may be negative) and tags; it starts counting at the alarm time |
| Save an inline target to the library | ✓ Approved | "Save to library" turns the inline timer or relay into a saved one, which the alarm then uses |
| Notify target | ✓ Approved | A heads-up notification instead of ringing, for alarms and calendar reminders (#14). Confirmed on the device |
Build step 6. Spec §07. Confirmed on-device.
| Feature | Status | Note |
|---|---|---|
| Multiple, name, t₀, lap / pause / restart / delete | ✓ Approved | Add with optional name and start offset; starts at once. Restart goes back to t₀, clears laps, keeps running if it was |
| Persisted in Room | ✓ Approved | Wall-clock based, so a running stopwatch keeps counting across a reboot. 7 unit tests |
| Lap notes | ✓ Approved | Tap a lap to add or edit its note; lap times stay read-only. First lap measured from t₀ |
| Ongoing notification with Lap / Pause | ✓ Approved | Counting chronometer with Lap and Pause, only while running |
| Stopwatch tags and one-tap tagged laps | ✓ Approved | Per-stopwatch tag list; laps take tags alongside notes; a Lap button per tag while running |
| Lap corrections: remove, insert, adjust | ✓ Approved | Boundary edits that keep the total; never below zero; optional label; ★ on changed laps. 13 unit tests on the logic |
| Correction history with unlimited undo and redo | ✓ Approved | Per stopwatch; undone entries greyed until a new correction; survives new laps; cleared by restart |
| Lap chart with tag filter and stats | ✓ Approved | Bars per lap in order, tap for the exact time, dashed average; count, average, fastest, slowest |
| Editing recorded lap times | ✕ Declined | A stopwatch is a factual record |
Build step 7. Spec §08, §09. Confirmed on-device.
| Feature | Status | Note |
|---|---|---|
| Large main clock + locations list | ✓ Approved | Main clock in the chosen style, then cities with day and offset ("Tomorrow, +9 h"). Search the time-zone database; swipe to delete, long-press to drag |
| Home clock while travelling | ✓ Approved | Settings → Home time zone. Shown at the top of the cities when the phone is in a different zone |
| ClockStyle: digital and analogue options, colors | ✓ Approved | Fonts: system, serif, mono, 7-segment (DSEG7) and a display face (Fraunces), both bundled under the SIL OFL. Analogue: hands, marks, face, second hand. A colour per element: Auto, palette, or custom. One renderer for app and widgets |
| Per-instance widgets with style and location | ✓ Approved | Each widget is drawn as a bitmap from its own settings, so fonts, gradients and borders match the app. Configure on placement and from "Widget settings"; tap opens the app on the last pane (v1.1, see below); minute ticks via a non-wakeup alarm |
| World-clock list and next-alarm widgets | Deferred | After 1.0 |
| Export stopwatch laps (CSV) | Deferred | After 1.0 |
Requested after the v1.0 device test. Code written 2026-10-24, not yet compiled (no JDK/SDK on the Pi) or device-tested.
| Feature | Status | Note |
|---|---|---|
| Open on the last pane | ✓ Approved | App icon and widget tap open the last of Alarms / Timers / Stopwatch / Clock (Settings isn't remembered). Stored in DataStore last_pane
|
| Timer length keypad | ✓ Approved | Own keypad: digits, h/m/s, backspace (long-press clears), +1m/+5m/+10m. Keyboard icon swaps to full text. New timers open empty with the keypad up, length first |
| Warned timer | ✓ Approved | "Warn before the end" + cue on a timer: runs as two seamless steps, one countdown to the real end. DB v7 (warnSeconds, warnTone) with migration and test. 3 PlanBuilder tests |
| Running timer / stopwatch notifications visible | ✓ Approved | Were on a LOW channel, so Android folded them under "Silent". New default-importance channels (timers_running, stopwatch_running) with no sound or vibration; old channels deleted |
| Feature | Status | Note |
|---|---|---|
| Bedtime | Deferred | Feasibility spike first |
| Automation: standard clock intents, batch import, AppFunctions | Deferred | Spec §12 |
| Scheduled actions: webhooks and Tasker | Deferred | Not designed yet. Outbound twin of the automation item |
| Calendar pane: events and reminders | ✓ Approved | Spec §10b, #14. Month grid, events and reminders with weekly/monthly/yearly repeats; reminders are ordinary schedules. Settings moved to a header gear. Liked on the device |
| Calendars: colours, defaults, show/hide | ✓ Approved | #34. Personal, Birthdays, Alarms to start; every item and alarm in one; colours on dots, rows and widgets; per-widget calendar ticks. Confirmed on the device, v9 update included |
| Calendar files (.ics) | ✓ Approved | #33. Import (open, share or pick; update by UID; odd repeats kept as a note) and export (a calendar or one item); read-only subscriptions to an https/webcal address, refreshed on open after 6 h. Confirmed on the device; odd-repeat and oversized files not tried there (unit-tested) |
| Richer repeats | ✓ Approved | #43. Every N days/weeks/months/years, the nth or last weekday, the last day, a count; one RRULE evaluator for grid, widgets and reminders. Confirmed on the device |
| Multi-day items as one entry | ✓ Approved | #35. One bar across the days in the grid and month widget; listed once with its dates. Confirmed on the device |
| Calendar widgets (agenda and month) | ✓ Approved | Spec §10b, #15. Native Glance: a 7-day agenda and a month grid with coloured day labels, each with its own calendars and frame; month/year picker in the pane. Confirmed on the device after layout fixes |
| Google Calendar link | ✓ Approved | Spec §10b, #16. CalendarContract, no OAuth: phone calendars read in as ticked, read-only calendars; a Relay calendar can copy its items to one. Both confirmed on the device |
Relay · feature map · a living ledger, not a roadmap; update it as things move