SPB Git

Repository Public License

spborix-alarm

ORIX Alarm — a native iPhone alarm built on AlarmKit: real system alarms, progressive wake with a simulated sunrise, ten wake missions (maths, memory, QR, steps, logic, maze), Alarm Studio and honest statistics. No account, no tracking, no network code.

13 entries at the root
History

Latest commit Build 2: 1.0.0 (2) uploaded to TestFlight ead41fc

NameLast commitUpdated
App Documentation, real screenshots, release scripts; 1.0.0 (1) uploaded to TestFlight
docs Build 2: 1.0.0 (2) uploaded to TestFlight
Packages Missions: QR Escape, QR tag management, Step Challenge, Logic Gates, Maze Escape
Scripts Documentation, real screenshots, release scripts; 1.0.0 (1) uploaded to TestFlight
Shared AlarmKit simulator probe; stops observed from system state (no dependency on intent delivery)
Tests Alarm engine tests, widgets, Live Activity, App Intents
UITests End-to-end UI tests and simulated wake hook
Widgets Alarm engine tests, widgets, Live Activity, App Intents
.gitignore Foundation: AlarmCore package, app model, system alarm service, design system, mission runner,...
CHANGELOG.md Build 2: 1.0.0 (2) uploaded to TestFlight
LICENSE Foundation: AlarmCore package, app model, system alarm service, design system, mission runner,...
project.yml Build 2: 1.0.0 (2) uploaded to TestFlight
README.md Build 2: 1.0.0 (2) uploaded to TestFlight
README.md View source
ORIX Alarm logo



ORIX Alarm icon

# ORIX Alarm

Wake smarter. Rise better.

Real system alarms, progressive wake, ten wake missions, Alarm Studio and honest statistics —
a native iPhone alarm with no account, no ads, no tracking and no network code.

Author: Simon-Pierre Boucher

iOS iPhone Version Status author

Swift SwiftUI AlarmKit WidgetKit App Intents Dependencies

Missions Tests Privacy Offline


Today dashboard Alarm editor with circular time selector Alarm Studio Pattern Lock mission Nightstand mode

All screenshots in this repository are captured from the running app (Scripts/screenshots.sh, demo data).

# What it is

ORIX Alarm is an alarm clock built on AlarmKit: the alarm belongs to iOS, so it rings when the app is closed, the iPhone is locked, a Focus is on or the ring switch is silent. Around that reliable core:

  • Alarms — one-time and weekly, each with its own sound, snooze policy and scenario; every alarm shows a verified status read back from the system, never an assumption.
  • Wake missions — ten of them, chained into a "Morning Combo": Math Blitz, Memory Matrix, QR Escape, Step Challenge, Pattern Lock, Word Scramble (English and French), Logic Gates, Maze Escape, Color Sequence, and the combo itself. Fixed or adaptive difficulty.
  • Progressive wake — Nightstand mode: a sunrise simulation and a soundscape that rise along a curve you choose (linear, exponential, smoothstep, multi-stage or drawn by hand).
  • Smart snooze — fixed or decreasing durations, a maximum count, optional difficulty escalation.
  • Alarm Studio — eight templates, a visual timeline of the whole morning, saved scenarios you can duplicate, reorder and apply.
  • Sleep planner — bedtime, time in bed, wind-down reminders, evening routine checklist, weekly consistency.
  • Insights — charts over 7 days, 30 days or a custom range, from recorded events only.
  • Widgets, Live Activity, Shortcuts — five widgets, the snooze / focus-timer countdown on the Lock Screen and Dynamic Island, seven Siri shortcuts.
  • Design — five animated clock faces, a midnight-to-sunrise identity, synthesised original sounds, Core Haptics.

# What it does not pretend

  • iOS always lets you stop or silence a system alarm. A mission is a commitment you set for yourself, not a lock; an emergency exit is always there and is recorded.
  • The sunrise and the soundscape need the app open in Nightstand mode. iOS does not let an app start sound or light the screen on its own before the alarm. The alarm itself rings regardless.
  • Stopping an alarm is not waking up. Only your "I'm up" confirmation counts as a wake-up in statistics.
  • The app does not measure sleep and does not estimate sleep stages.
  • Step counting is approximate.

Details: docs/ALARMKIT.md.

# State of verification

Logic (recurrence, DST, policies, puzzles, storage, statistics) 100 unit tests, swift test
Alarm lifecycle against a fake system (create, modify, cancel, reconcile, relaunch, denial, snooze chain, missions, corrupted data) 27 integration tests
Interface (onboarding, alarm creation, denial, tabs, full simulated wake, emergency exit, missions played to the end) 17 UI tests on the iOS 26.5 simulator
Real AlarmKit on the simulator (2 opt-in probe tests) permission prompt, scheduling, ringing with the app in the background, stop observed and recorded, mission presented
Real iPhone nothing yet — lock screen, silent switch, Focus, restart, audio routes, camera, pedometer, haptics are unverified
Snooze button and stop-intent delivery from the system alert not confirmed: the simulator's alert could not be driven reliably. See docs/TESTING.md

# Build

Requirements: Xcode 27 (iOS 26.1+ SDK), XcodeGen.

bash
Scripts/build.sh build        # generate the project and build for the simulator
(cd Packages/AlarmCore && swift test)
Scripts/build.sh test         # integration tests
Scripts/build.sh uitest       # interface tests
Scripts/probe-alarmkit.sh testObservedStopRetiresOneTimeAlarm   # real AlarmKit on the simulator
Scripts/screenshots.sh        # real screenshots into docs/screenshots
Scripts/release.sh archive | export | validate | upload

# Documentation

ARCHITECTURE modules, data flow, concurrency
ALARMKIT scheduling, reconciliation, intents, limits
MISSIONS the ten missions, difficulty, fallbacks
DESIGN_SYSTEM palette, typography, components, sound, haptics
TESTING what is tested, how, and what is not
PRIVACY data, permissions
TESTFLIGHT Apple identity, release procedure, current build
CHANGELOG versions

# Privacy

No account, no server, no analytics, no advertising SDK, no network code. Camera frames and motion data are processed on the device and never stored. See docs/PRIVACY.md.

# License

Copyright © 2026 Simon-Pierre Boucher. All rights reserved. The source is published for reading; see LICENSE.

Clone orix-alarm

Anonymous clone and fetch. Pushing requires the owner's personal access token.

Snapshot of main

Files main
Menu

Theme