A modern Quran reading app for iPhone, iPad, and Mac — the diacritized Uthmani text and English & Indonesian translations read fully offline, with online audio recitation from 150+ reciters, a curated Dua collection, and a personalized For You tab that recommends verses based on the time of day. Built entirely in SwiftUI, with full dark mode support.
What's Inside
Quran Firdaus 4.2 — released August 2026.
The full diacritized Uthmani Arabic text, with English and Indonesian translations, read entirely offline — no connection needed. Choose from up to 4 Arabic reading fonts to match your taste.
Streamed audio recitation with background playback and Lock Screen artwork. Pick your preferred voice — from Mishary Alafasy to Yasser Al Dosari — from a library of 150+ reciters in Settings.
An NLP-based sentiment analysis feature scores verses on-device and surfaces uplifting, motivational ones through a dedicated filter — no server round-trip, no data leaving your device.
A themed collection of supplications — Forgiveness, Protection & Refuge, Guidance, Gratitude, and more — each sourced verse-by-verse, with its own saved-Dua list.
A "Right Now" card recommends a Surah based on the time of day (Fajr, before sleep, Friday, and more), alongside a most-visited-chapters chart of your own reading habits.
A configurable Home Screen and Lock Screen widget — choose Arabic-only, with translation, or Dua content — plus scheduled verse notifications, new in v4.2.
Six built-in App Intents — ask Siri for a random verse, your bookmark, a Surah recommendation, your most-visited chapters, or a motivational verse, hands-free.
Platform Support
A single SwiftUI codebase adapts seamlessly across the full Apple device lineup.
Compact layout — Quran, Dua, and For You tabs, plus the audio mini-player. Full dark mode.
Master-detail split view — browse chapters on the left, read on the right. Optimised for large screens.
Native Mac app (Apple Silicon & Intel) via the same SwiftUI codebase — restored and hardened in v4.0.
Complete Stack
My Role
Built Quran Firdaus as an independent personal project — designed and developed the full app from scratch, from the original 2023 reading experience through the 2026 rebuild. Key engineering work includes the cross-platform SwiftUI UI, the offline CoreData Quran dataset, SwiftData-backed Dua bookmarks, an on-device Natural Language sentiment-analysis (NLP) model for motivational-verse filtering, and the WidgetKit / App Intents integrations that power the widget, notifications, and Siri Shortcuts.
Engineering Workflow — 2026
Starting in 2026, Quran Firdaus development embraced agentic AI coding with Claude Code. Feature planning happens as a design conversation with Claude before a line of code is written, and the day-to-day engineering work — from scaffolding new API layers to shipping App Store releases — runs through a set of custom Claude skills built specifically for this codebase's architecture.
data-layer
Scaffolds and reviews new API domains following the app's Model → TargetType → RemoteDataSource → Repository architecture.
unit-testing
Writes and reviews XCTest and Swift Testing coverage for repositories and view models against the project's own testing conventions.
prepare-app-store-release
Drives version bumps, screenshot renewal, and build archive/export/upload through the App Store Connect API.
post-release-sync
Merges and tags the release once Apple approves it — kept as a separate, explicit step so main only ever reflects what's actually live.
Even this landing page update was researched and shipped by a Claude Code agent — reading the live codebase, pulling current App Store screenshots, and publishing the result.
Since 2023
Quran Firdaus is born. First commit in January; the original SwiftUI master-detail reading experience takes shape, culminating in v1.4.0 that April and steady iteration through the year.
A quiet year. No shipped releases — the calm before a much larger rebuild.
The comeback, and the growth year. Development resumes in April with v1.4.x–v1.7.x and bookmarks. By autumn: Siri & App Intents, an on-device NLP-based sentiment filter for motivational verses, and a full audio player with reciter selection. The year closes with v3.0.0 on December 31 — an architecture refactor setting up everything that follows.
The biggest leap yet — and an agentic one. v4.0.0 (July) brings diacritized Uthmani text, up to 4 Arabic reading fonts, and restores native macOS support. v4.2.0 (August) adds Home & Lock Screen widgets, scheduled notifications, and the personalized "For You" tab. Just as significantly, 2026 is the year the engineering workflow itself changes: feature planning and day-to-day development move to agentic AI coding with Claude Code skills.
Coming to Android. A native Android app is next on the roadmap — planned to be built with the same agentic Claude Code workflow driving iOS, iPadOS, and macOS development today.