AdhanHub
My role: iOS app — designed and built solo, end to end
AdhanHub calculates prayer times on the device and keeps working without a connection: adhan alerts, a qibla compass, the Quran and other prayer content. I built the iOS app on my own, from the calculation engine and notification scheduling to the WidgetKit widget and the App Store release.
- Swift
- SwiftUI
- SwiftData
- WidgetKit
- Swift Testing
- Firebase
Highlights
- PlatformiOS 18+ · SwiftUI with @Observable
- Languages10 UI languages, offline prayer-time calculation
- Codebase216 Swift files across app, widget and test targets
- Tests210 Swift Testing cases covering times, alarms and widget
Architecture
The app is split into a Core layer (Calculation, Notifications, Persistence, Location, Settings, Widget, Account, RemoteConfig) and a SwiftUI UI layer organised by feature: home, calendar, compass, Quran, tasbih, onboarding and more. Dependencies are wired by hand through an AppContainer injected via the SwiftUI Environment, with @Observable view models on top.
Prayer data and content live in SwiftData; the app talks to a separate AdhanHub account API only for the optional sign-in.
Offline Prayer Engine & Alerts
The astronomical calculation is a hand port of the open-source adhan-swift engine, extended with calculation methods, minute offsets and restricted-prayer-time windows. Results go into a 30-day SwiftData cache that is recomputed only when coordinates move, today's row is missing or the parameters change.
Local notifications are scheduled as a rolling 7-day window under iOS's 64-pending-request ceiling, with the main alerts budgeted first and reminders filling the remaining slots.
Widget & Quality
A WidgetKit extension shows the current and next prayer. The app writes a localized snapshot of the 30-day times into a shared App Group container, so the widget never reads SwiftData and can plan its own timeline transitions while the app is closed.
A golden-reference test compares calculated times to reference data, and a localization-coverage suite checks that all 10 languages resolve real strings instead of silently falling back. The binary ships a privacy manifest and Firebase Crashlytics and Remote Config for monitoring.
Skills Demonstrated
| Skill Area | Evidence in Project |
|---|---|
| SwiftUI / @Observable | Full app UI by feature, hand-wired AppContainer DI via Environment |
| SwiftData | 30-day prayer cache with recompute rules, content entities, settings migration |
| WidgetKit | Prayer widget fed by App Group snapshot, self-planned timeline |
| Local notifications | Rolling 7-day window within the 64-request limit, per-prayer sounds |
| Swift Testing | 210 tests: golden prayer times, alarm chains, widget logic, localization |
Want to discuss this project or work together?
Get in touch