How dr33awi/dhakarani_app works
Dhakarani is a Flutter Islamic companion app. The main user workflow begins in the app and routes to features for daily worship, prayer times, and personal practice; supporting capabilities include Quran reading, Qibla direction, and settings. The tree supports these capability areas, while the sampled native code confirms Android integrations for prayer widgets, adhan playback, notifications, and floating athkar. Flutter feature-to-feature and data-layer wiring is not shown in the excerpts, so those links are omitted.
Main entry points: main.dart Flutter entry · app_router.dart App routes · OverlayAthkarForegroundService.kt Floating athkar · MainActivity.kt Flutter Android bridge
Components 20
App experience
- Flutter entry
lib/main.dart - App routes
lib/app/routes/app_router.dart - Home dashboard
lib/features/home - Settings
lib/features/settings
Worship content
- Athkar
lib/features/athkar - Duas
lib/features/dua - Daily content
lib/features/daily_content - Names of Allah
lib/features/asma_allah - Quran reader
lib/features/quran
Prayer tools
- Prayer times
lib/features/prayer_times - Qibla direction
lib/features/qibla
Practice tools
- Prayer tracking
lib/features/prayer_tracking - Tasbih counter
lib/features/tasbih
Android services
- Floating athkar
android/app/src/main/kotlin/com/dhakarani/app/overlay/OverlayAthkarForegroundService.kt - Overlay window
android/app/src/main/kotlin/com/dhakarani/app/overlay/OverlayWindowController.kt - Adhan playback
android/app/src/main/kotlin/com/dhakarani/app/adhan/AdhanPlayerService.kt - Prayer widget
android/app/src/main/kotlin/com/dhakarani/app/PrayerWidget/PrayerWidgetProvider.kt - Flutter Android bridge
android/app/src/main/kotlin/com/dhakarani/app/MainActivity.kt
Other components
- App user
- Android system
Connections 7
- App user → Flutter entry: opens app
- Flutter entry → App routes: starts routes
- App routes → Home dashboard: routes to
- Flutter Android bridge → Floating athkar: starts service
- Floating athkar → Overlay window: shows dhikr
- Android system → Prayer widget: updates widget
- Android system → Adhan playback: starts playback