How islamsamfawzy/islami-app-islam works
islami is a Flutter Islamic-practice companion app. Its repository provides Quran reading and progress, prayer times and adhan reminders, Qibla direction, prayer guidance, azkar, hadith, tasbeh, radio/reciter playback, and downloads. The likely user workflow is to open the app, select a devotional feature, and view or use its content; only the native adhan and method-channel wiring is visible in sampled source, so Flutter feature-to-feature links are omitted. The native alarm path is explicit: Android schedules alarms, a receiver starts adhan playback and schedules the next occurrence, with a reminder notification fallback.
Main entry points: AdhanScheduler.kt Adhan scheduler · AdhanReceiver.kt Prayer alarm receiver · MainActivity.kt Android method channels · AdhanService.kt Adhan playback service
Components 26
App experience
- Flutter app
lib/main.dart - Home navigation
lib/features/home/presentation - Intro and onboarding
lib/features/intro/presentation - Shared services
lib/core/services
Devotional content
- Quran reading
lib/features/quran - Sura content
assets/files/suras - Azkar
lib/features/azkar - Azkar content
assets/files/azkar - Hadith collection
lib/features/hadith - Hadith content
assets/files/hadeeth
Prayer tools
- Prayer guide
lib/features/prayer_guide - Guide content
assets/files/prayer_guide - Prayer times
lib/features/time - Qibla compass
lib/features/qibla - Tasbeh counter
lib/features/tasbeh
Audio and downloads
- Radio and reciters
lib/features/radio - Audio downloads
lib/features/downloads
Android adhan runtime
- Android method channels
android/app/src/main/kotlin/com/thecofounderstudio/islami/MainActivity.kt - Adhan scheduler
android/app/src/main/kotlin/com/thecofounderstudio/islami/AdhanScheduler.kt - Schedule recovery
android/app/src/main/kotlin/com/thecofounderstudio/islami/AdhanBootReceiver.kt - Prayer alarm receiver
android/app/src/main/kotlin/com/thecofounderstudio/islami/AdhanReceiver.kt - Adhan playback service
android/app/src/main/kotlin/com/thecofounderstudio/islami/AdhanService.kt - Fallback reminder
android/app/src/main/kotlin/com/thecofounderstudio/islami/AdhanReminderNotification.kt
Other components
- App user
- Android alarm manager
- Android system
Connections 13
- App user → Flutter app: uses
- Android method channels → Adhan scheduler: schedules alarms
- Android method channels → Adhan scheduler: cancels alarms
- Android method channels → Android system: reads declination
- Adhan scheduler → Android alarm manager: arms
- Android alarm manager → Prayer alarm receiver: fires
- Prayer alarm receiver → Adhan scheduler: reschedules prayer
- Prayer alarm receiver → Adhan playback service: starts playback
- Prayer alarm receiver → Fallback reminder: shows on failure
- Adhan playback service → Android system: plays audio
- Adhan playback service → App user: notifies
- Schedule recovery → Adhan scheduler: restores schedule
- Adhan scheduler → Android system: persists schedule