Skip to content
YA
All work
LiveAndroidAI

NURنور

A premium Islamic learning app with a recitation coach that listens as you recite from memory.

Status
Live on Google Play (app.nur.android) — listing checked while building this portfolio.
Period
2026
Platforms
Android
Repository
Private — available on request
NUR feature graphic

01Overview

Quran reader with translation, tafsir and recitations; prayer times, Hijri calendar and alarm-clock-grade prayer alarms; lessons and quizzes with XP, streaks and achievements; memorization with live recitation feedback; friends and battles; and an opt-in prayer focus mode. Arabic and English, RTL-first, dark by design.

By the numbers

Kotlin files
443
Kotlin files
source tree
commits
109
commits
git history
Gradle modules
34
Gradle modules
settings.gradle.kts
languages, RTL-first
2
languages, RTL-first
README
  1. 02The problem

    Learning apps for the Quran tend to be either reliable but dated, or polished but loose with sources. Memorization is the hardest part, and most apps can only play audio — they cannot tell you where you went wrong.

  2. 03The vision

    One calm, beautiful companion where everything is cited, reviewed and yours to read at your own pace — and a coach that listens.

  3. 04The solution

    A 34-module Compose codebase with strict rules: features depend only on core, the Quran text is Tanzil verbatim and never modified, the client never asserts XP or scores (the server verifies evidence), and a feature without its backend shows an honest unavailable state.

05Key features

  1. 01

    Recitation coach

    Verses stay hidden until you recite them. Two engines: online recognition for accuracy, or an offline Vosk engine so audio never leaves the phone. Mistakes are shown word by word, with weak words to practise.

  2. 02

    Prayer times that work offline

    Calculation method and Asr school per user, Hijri dates with day adjustment, high-latitude rules, upcoming occasions and alarm-clock-grade alarms.

  3. 03

    Learning journeys

    Daily challenges, quizzes rising in difficulty, levels, XP and streaks — with progress verified server-side.

  4. 04

    Prayer focus

    An opt-in mode that pauses chosen apps around prayer time.

06Screens

In motion

NUR promo reel

NUR promo reel

07System architecture

  1. L1App shell
    • Navigation 3 host
    • Hilt wiring
    • Application
  2. L2Features
    • quran
    • prayer
    • recite
    • memorize
    • learning
    • quiz
    • social
    • focus
    • alarm
  3. L3Core
    • designsystem
    • ui
    • navigation
    • media
    • notifications
    • speech
    • recitation
    • security
  4. L4Data
    • Room
    • DataStore
    • Retrofit
    • repositories
  5. L5Domain
    • models
    • use cases
    • repository contracts
  6. L6Server contract
    • OpenAPI
    • verified XP
    • social
Pure-Kotlin model and domain modules, Android core modules for data, media, speech and recitation, and isolated feature modules. Only the app module maps navigation keys to screens.Diagram — derived from the source code

08Engineering decisions

  1. Screenshot tests instead of an emulator loop

    Screens are rendered by Robolectric with native graphics and written to PNG in each module — the screens on this page come from those tests, in both languages.

  2. Lint warnings are errors

    The standard check is warnings-as-errors lint plus all tests, with no hard-coded UI strings anywhere.

  3. Content integrity and licences

    Quran text from the Tanzil Project, verbatim; translations, tafsir and recitations credited with their licences in the About screen.

09Lessons learned

Honest unavailable states build more trust than a polished fake.

My contribution

Designed and built end to end — 443 Kotlin files across the modules, 109 commits.

Technology

  • Kotlin
  • Jetpack Compose
  • Material 3
  • Navigation 3
  • Hilt
  • Room
  • DataStore
  • Retrofit
  • Coroutines
  • Flow
  • Vosk
  • Robolectric
  • Multi-module
  • Clean Architecture

How this was verified

Source and docs reviewed; the Google Play listing was checked live. Screens come from a real phone and from the project's own Robolectric screenshot tests.

Related projects

Next project

NOVA