LunkAlarm is an alarm clock available as a website, a native Android app, and a native iOS app. It combines a large clock, custom themes, ringtones, and optional wake-up tests.
Open the website → alarm.reeeserve.online · Download mobile builds
| Platform | Get started | Requirements | Source and setup |
|---|---|---|---|
| Website | alarm.reeeserve.online | A modern browser | web/ · Deployment guide |
| Android | Download the APK | Android 8.0 or later | android/ · Android guide |
| iOS | Releases · IPA builds | iOS 26 or later; Apple signing/provisioning | ios/ · iOS guide |
The Android app uses Kotlin and Jetpack Compose. The iOS app uses SwiftUI and AlarmKit. Both are native apps with their own system alarm integration. The standalone website runs directly in a browser.
The repository also retains the earlier native C# / WPF Windows implementation in src/. A native macOS app remains future work.
- A large clock-first screen with local date, time zone, and 12/24-hour display. Swipe up to view alarms and down to return to the clock.
- Saved alarms with optional names, daily or selected-weekday repeats, editing, duplication, and swipe-to-delete with haptic feedback.
- Active countdowns alongside saved alarms. Completed countdowns disappear; At a time alarms stay until deleted.
- Floating Add alarm / Save changes buttons, time and duration wheels, and collapsible wake-up test settings.
- Nineteen app-owned themes, ten offline ringtones, sound previews, audio-file imports, a volume slider, and optional gradual fade-in.
- Configurable timed typing and math tests, automatic math answer submission, an answering sound switch, and progress resets when a test times out. Both mobile apps also include puzzle, Minesweeper and Sudoku tests, with platform-specific options described below.
- Native alarm scheduling so a scheduled alarm does not depend on keeping the clock screen open.
Choose wake-up tests using five icon tiles. Enabling a tile opens its settings; disabling it leaves the other selected tests enabled. Each test has a Try button for a practice run you can exit anytime without scheduling an alarm. Test settings use fixed buttons and bounded − / + controls instead of looping wheels.
| Wake-up test | Options | Time limit |
|---|---|---|
| Typing | 4–10 code characters | 15 / 20 / 25 / 30 seconds |
| Math | 1–8 addition problems; built-in or native Android keypad | 5 / 10 / 15 seconds per question |
| Puzzle | 6 / 8 / 10 randomized jigsaw pieces | 15–40 seconds in five-second steps |
| Minesweeper | Easy 3×3, Medium 4×4, Hard 5×5 | 15–40 seconds in five-second steps |
| Sudoku | Easy: 4×4 easy; Medium: 4×4 hard; Hard: 6×6 easy; Difficult: 6×6 hard | 30 / 60 / 90 / 120 seconds |
Minesweeper boards have a safe opening and can be solved from their clues without guessing. Every generated Sudoku has one solution. Puzzle boards hide empty-piece outlines and provide exactly one snap position per piece; placement progress appears above the instructions. The typing answer field has a faint outline and placeholder.
Enabled tests run in sequence. A timeout restarts the configured sequence and restores alarm audio; hitting a mine does the same. Practice runs stay separate from saved alarms and live progress. The clock, time/duration pickers, ringtone controls, themes and navigation retain their existing design.
This section describes Android 1.2.0. See the Android guide for game rules, installation and build instructions. The verified Android 1.2.0 build passed 27 core tests, 18 emulator UI tests, the denied-permission check, and Android lint.
The native iPhone app now includes all five wake-up tests, finite settings controls, a wider Try button, and full-screen practice that stays open when the typing keyboard appears. Puzzle boards have 6/8/10 pieces and support drag or tap placement.
- Minesweeper: Easy 5×5, Medium 7×7, Hard 9×9. Hold a hidden square to flag; hold a revealed number to open adjacent unflagged squares when its flag count matches. Timers remain 15–40 seconds in five-second steps.
- Sudoku: 4×4 easy/hard or 6×6 easy/hard, with 60 / 120 / 180 / 240-second buttons.
- In-app vibration: a subtle checkbox beside alarm volume controls vibration during audible foreground playback/previews. AlarmKit does not expose per-alarm Lock Screen vibration control.
The existing clock, themes and system alarm delivery are retained. Actual test progress is saved across app restarts; practice stays separate from real alarms. See the iOS guide for behavior and setup.
The verified iOS 1.7.0 build passed 31 core tests and 18 simulator UI tests, including typing with the keyboard open, game-board alignment, theme navigation and full-swipe deletion. Its LunkAlarm-iOS artifact contains LunkAlarm-iOS-unsigned.ipa; signing/provisioning is required before installation. This release updates iOS; Android remains at 1.2.0.
Alarms, themes, and imported sounds are saved locally on each device. There is no account requirement or cross-device synchronization. The website and mobile apps have separate saved data, and some features differ by platform.
Android: Download the .apk from Releases, or extract artifacts/LunkAlarm-Android-1.2.0.apk from the LunkAlarm-Android artifact in the verified 1.2.0 build. Open it on your phone, and allow installation from your browser or file manager if Android asks. In LunkAlarm, open Alarm access and enable alarms, notifications, and full-screen alarms where available. Overall sound level uses your device's alarm volume.
iOS: Download the .ipa from Releases when attached, or extract it from a successful Native iOS app Actions build. The cloud-generated IPA is unsigned and needs signing/provisioning through AltStore Classic/AltServer or another compatible signing tool before installation. GitHub hosting does not replace Apple's signing requirements. See the iOS guide for setup and build instructions.
These are development/test builds, separate from App Store or Google Play distribution. Test a short alarm with the phone locked before relying on it overnight. System permissions, volume, Focus/Do Not Disturb, force-stop behavior, and device battery settings affect alarm behavior; the platform guides explain the differences.
Use alarm.reeeserve.online directly, without installing an app. Keep the page open, sound available, and the device awake: browsers can delay background tabs, and the website cannot wake a sleeping device.
To deploy your own copy with Vercel, use Root Directory web and Framework Preset Other. No build/install command, database, Supabase connection, or environment variables are required. Add your domain in Vercel and configure the DNS records Vercel provides. See the Namecheap + Vercel deployment guide.
| Directory | Contents |
|---|---|
web/ |
Browser app and Vercel configuration |
ios/ |
Native SwiftUI app, AlarmKit integration, core/UI tests, and Xcode project |
android/ |
Native Compose app, Android alarm service, core/UI tests, and Gradle project |
src/Wake.Core/ |
Earlier Windows scheduling, persistence, challenges, and sound synthesis |
src/Wake.Windows/ |
Earlier native WPF Windows app |
docs/ |
Deployment and Windows documentation |
The Native iOS app workflow builds simulator/device targets, runs core and native UI tests, and uploads an unsigned IPA. The Native Android app workflow builds a signed development APK, runs core tests, Android lint, and emulator checks, and packages successful builds in its LunkAlarm-Android Actions artifact. GitHub Releases are uploaded manually by the maintainer. Each platform guide includes local build commands and installation details.
MIT license. The supplied app's icon and original sound recipes are reused.