Skip to content

Visual Direction and Build Order

Håkon Olav Torvik edited this page Oct 24, 2026 · 1 revision

Visual Direction and Build Order

Part of the Relay design spec. See the contents.

15 · Visual direction keep

Look

Material 3 as the base, pushed so it doesn't read as stock. Seed tokens:

Colour Hex
ink 151513 #151513
paper F4F2EA #F4F2EA
accent C7501E #C7501E
teal 2E6F66 #2E6F66
brass 7A6A4F #7A6A4F

Rev 7 finding: keep the cream paper background in light and the warm olive-black (#1C1E17) in dark; a cooler near-white and a grey dark both tested as bleak. What changed: every Material colour role is set explicitly (anything left out falls back to Material's default purple, which tinted selected chips lavender). Selection is warm grey in light and an orange tint in dark. Orange text is #B4461A on paper (4.9:1) and #E8682F on dark (5.2:1).

A bundled display face with character for the large clock digits, a plain workhorse face for lists, and tabular numerals wherever digits line up. v0.5 only used system serif and mono.


16 · Build order

Order of work

  1. Foundation: project skeleton, theme tokens, navigation, i18n setup, Room with a migration test harness, chainlang carried over with its tests. Fresh start, with no import from v0.5: the new applicationId is com.relay.app, so v1.0 installs alongside the old v0.5 build and never touches its data. The old app keeps firing its alarms until you uninstall it by hand, once v1.0 alarms are proven on the device.
  2. Firing module + Ring schedules: plain alarms end to end, including full-screen, looping audio, snooze, exceptions, upcoming notification and boot rescheduling. Test on the device before moving on.
  3. Run engine + Timers: persisted runs, parallel runs, quick-start, library with headers.
  4. Relays: ref arithmetic in chainlang, the script editor with autocomplete, transitions.
  5. Scheduled targets: Timer, Relay and Stopwatch on the Alarms pane.
  6. Stopwatch (persisted).
  7. Clock pane + ClockStyle renderer + widgets.
  8. v1.1: open on the last pane, quick starts beside the +, the length keypad, warned timers, visible running notifications.
  9. After 1.0: automation (standard clock intents, then batch import, then AppFunctions after a spike), Bedtime (after a feasibility spike), extra widgets, calendar events (§10b).

Status: steps 1 to 7 are done; "After 1.0" is what's left.

Worth salvaging from v0.5

  • chainlang/ in full, including its tests.
  • The AlarmScheduler next-trigger math, including exceptions. It's target-agnostic already.
  • Library header and drag-reorder logic. The analogue hand-angle geometry. The strings.xml translations (en + nb). gitVersionName().

17 · Open questions

Undecided

None right now. One decision is provisional until it's tried on a working prototype:

  • Per-step override UI (§05): tap a step in the live preview to override it.

Relay · spec v1.0 · clean-restart baseline, update as screens get built

Clone this wiki locally