How user-zak/furqan works
Nadir is a Quran-focused reading and worship app with recitation practice, prayer tools, group reading, and a social recitation community. The main reader flow loads a Mushaf page, renders Quran text, and supports translation and recitation playback. Other user workflows include practicing memorization, publishing and discovering recitations, and coordinating group reading. The source index supports several connections; where implementation was not sampled, I show documented module references rather than assuming deeper control flow.
Main entry points: read/page.tsx Mushaf reader · ayah/route.ts Ayah API · app/page.tsx Home screen · [id]/route.ts Group API
Components 23
Quran reading
- Mushaf reader
app/read/page.tsx - Quran page view
components/QuranPageView.tsx - Mushaf layout
lib/mushaf-engine/build-page-lines.ts - Quran data
lib/quran.ts - Ayah API
app/api/ayah/route.ts - Translations
lib/translations.ts - Page recitation
hooks/usePageRecitation.ts
Practice and worship
- Memorization practice
app/hifdh/random/page.tsx - Recitation recognition
hooks/useQuranAsr.ts - Offline recognizer
lib/asr/offline-recognizer.ts - Prayer and qibla
app/prayer/page.tsx
Reading community
- Group reading
components/halaqa/HalaqaScreen.tsx - Group API
app/api/halaqa/[id]/route.ts - Group operations
lib/halaqa-server.ts
Recitation community
- Recitation discovery
app/qari/page.tsx - Recitation API
app/api/qari/route.ts - Audio and image storage
lib/qari-storage.ts
Shared platform
- Home screen
app/page.tsx - App settings
app/settings/page.tsx - Settings persistence
lib/app-settings.ts - Authentication
lib/auth.ts - Application database
lib/prisma.ts
Other components
- App user
Connections 22
- App user → Home screen: opens
app/page.tsx - Home screen → Mushaf reader: navigates to
- Mushaf reader → Quran page view: renders
app/read/page.tsx - Mushaf reader → Quran data: loads pages
app/read/page.tsx - Mushaf reader → Page recitation: controls playback
app/read/page.tsx - Quran page view → Mushaf layout: uses layout
- App user → Ayah API: requests verses
app/api/ayah/route.ts - Ayah API → Quran data: reads Quran data
app/api/ayah/route.ts - Ayah API → Translations: checks editions
app/api/ayah/route.ts - App user → Memorization practice: practices
app/hifdh/random/page.tsx - Memorization practice → Recitation recognition: uses recognition
app/hifdh/random/page.tsx - Recitation recognition → Offline recognizer: delegates to
- App user → Prayer and qibla: checks prayer
app/prayer/page.tsx - App user → Group reading: joins reading
- Group API → Application database: queries
app/api/halaqa/[id]/route.ts - Group API → Group operations: uses group logic
app/api/halaqa/[id]/route.ts - App user → Recitation discovery: discovers recitations
app/qari/page.tsx - Recitation API → Application database: queries and saves
app/api/qari/route.ts - Recitation API → Audio and image storage: stores media
app/api/qari/route.ts - App user → App settings: configures app
app/settings/page.tsx - App settings → Settings persistence: updates preferences
app/settings/page.tsx - Home screen → Authentication: checks session
app/page.tsx