# aldikurniawan19/ramadhanku architecture

> Architecture diagram of the GitHub repository aldikurniawan19/ramadhanku, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aldikurniawan19/ramadhanku
- Repository: https://github.com/aldikurniawan19/ramadhanku

## Overview

Ramadhan Flutter is a mobile Islamic companion. Users enter through the app’s navigation and home experience, then access worship tools and reference content: Quran reading/audio, prayer schedules and location, hadith, daily duas, the Hijri calendar, and Qibla direction. Providers and data services form the documented internal state/data layer. Android also includes native adhan playback support. The README documents the capabilities and API sources; Dart implementation wiring was not sampled, so feature-to-service call edges are not asserted.

Main entry points: [`lib/features/main_navigation_screen.dart`](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/main_navigation_screen.dart) (Main navigation), [`android/app/src/main/kotlin/com/ramadhan/app/ramadhan_flutter/AdhanPlayerService.kt`](https://github.com/aldikurniawan19/ramadhanku/blob/main/android/app/src/main/kotlin/com/ramadhan/app/ramadhan_flutter/AdhanPlayerService.kt) (Android adhan service), [`lib/features/jadwal_sholat/screens/jadwal_sholat_screen.dart`](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/jadwal_sholat/screens/jadwal_sholat_screen.dart) (Prayer schedule), [`lib/features/kalender/screens/kalender_screen.dart`](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/kalender/screens/kalender_screen.dart) (Hijri calendar)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_navigation["Main navigation"]
  node_home["Home dashboard<br/>[home_screen.dart]"]
  node_auth["Login and registration<br/>[login_screen.dart]"]
end

subgraph group_worship["Worship tools"]
  node_prayer["Prayer schedule"]
  node_location["Location detection"]
  node_qibla["Qibla compass<br/>[kiblat_screen.dart]"]
  node_calendar["Hijri calendar"]
  node_events["Islamic event countdown"]
end

subgraph group_content["Islamic content"]
  node_quran["Quran reader"]
  node_quran_list["Surah discovery"]
  node_audio_player["Floating audio player"]
  node_murottal["Murottal playback"]
  node_hadith["Hadith library"]
  node_dua["Daily duas"]
end

subgraph group_data["State and data"]
  node_hadith_service["Hadith data service"]
  node_dua_service["Doa data service<br/>[doa_service.dart]"]
  node_providers["Feature state"]
  node_prayer_service["Prayer data service"]
  node_quran_service["Quran data service<br/>[quran_service.dart]"]
end

subgraph group_native["Native playback"]
  node_android_channel["Adhan method channel"]
  node_receiver["Adhan broadcast receiver"]
  node_player_service["Android adhan service"]
end

node_user(("App user"))
node_api{{"Open Islamic APIs"}}

node_user -->|"opens app"| node_navigation
node_navigation -->|"shows home"| node_home
node_navigation -->|"offers account access"| node_auth
node_navigation -->|"opens Quran"| node_quran_list
node_quran_list -->|"opens surah"| node_quran
node_quran -->|"plays recitation"| node_audio_player
node_navigation -->|"opens audio"| node_murottal
node_navigation -->|"opens schedule"| node_prayer
node_prayer -->|"uses GPS location"| node_location
node_navigation -->|"opens compass"| node_qibla
node_navigation -->|"opens hadith"| node_hadith
node_navigation -->|"opens duas"| node_dua
node_navigation -->|"opens calendar"| node_calendar
node_calendar -->|"shows countdowns"| node_events
node_api -->|"supplies Quran data"| node_quran_service
node_api -->|"supplies hadith data"| node_hadith_service
node_api -->|"supplies dua data"| node_dua_service
node_api -->|"supplies prayer data"| node_prayer_service
node_android_channel -->|"starts or stops"| node_player_service
node_receiver -->|"starts or stops"| node_player_service
node_player_service -.->|"plays adhan for"| node_android_channel

click node_navigation "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/main_navigation_screen.dart"
click node_home "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/home/screens/home_screen.dart"
click node_auth "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/auth/screens/login_screen.dart"
click node_quran "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/quran/screens/quran_detail_screen.dart"
click node_quran_list "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/quran/screens/quran_list_screen.dart"
click node_audio_player "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/quran/widgets/audio_player_bar.dart"
click node_murottal "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/murottal/screens/murottal_screen.dart"
click node_prayer "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/jadwal_sholat/screens/jadwal_sholat_screen.dart"
click node_location "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/data/services/location_service.dart"
click node_qibla "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/kiblat/screens/kiblat_screen.dart"
click node_hadith "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/hadits/screens/hadits_list_screen.dart"
click node_hadith_service "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/data/services/hadits_service.dart"
click node_dua "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/doa/screens/doa_list_screen.dart"
click node_dua_service "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/data/services/doa_service.dart"
click node_calendar "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/kalender/screens/kalender_screen.dart"
click node_events "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/data/services/islamic_event_service.dart"
click node_providers "https://github.com/aldikurniawan19/ramadhanku/tree/main/lib/providers"
click node_prayer_service "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/data/services/prayer_service.dart"
click node_quran_service "https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/data/services/quran_service.dart"
click node_android_channel "https://github.com/aldikurniawan19/ramadhanku/blob/main/android/app/src/main/kotlin/com/ramadhan/app/ramadhan_flutter/AdhanApplication.kt"
click node_receiver "https://github.com/aldikurniawan19/ramadhanku/blob/main/android/app/src/main/kotlin/com/ramadhan/app/ramadhan_flutter/AdhanBroadcastReceiver.kt"
click node_player_service "https://github.com/aldikurniawan19/ramadhanku/blob/main/android/app/src/main/kotlin/com/ramadhan/app/ramadhan_flutter/AdhanPlayerService.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_navigation,node_home,node_auth,node_user toneBlue
class node_prayer,node_location,node_qibla,node_calendar,node_events toneAmber
class node_quran,node_quran_list,node_audio_player,node_murottal,node_hadith,node_dua,node_api toneMint
class node_hadith_service,node_dua_service,node_providers,node_prayer_service,node_quran_service toneRose
class node_android_channel,node_receiver,node_player_service toneIndigo
```

## Components

### App experience

- [Main navigation](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/main_navigation_screen.dart): `lib/features/main_navigation_screen.dart`
- [Home dashboard](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/home/screens/home_screen.dart): `lib/features/home/screens/home_screen.dart`
- [Login and registration](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/auth/screens/login_screen.dart): `lib/features/auth/screens/login_screen.dart`

### Worship tools

- [Prayer schedule](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/jadwal_sholat/screens/jadwal_sholat_screen.dart): `lib/features/jadwal_sholat/screens/jadwal_sholat_screen.dart`
- [Location detection](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/data/services/location_service.dart): `lib/data/services/location_service.dart`
- [Qibla compass](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/kiblat/screens/kiblat_screen.dart): `lib/features/kiblat/screens/kiblat_screen.dart`
- [Hijri calendar](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/kalender/screens/kalender_screen.dart): `lib/features/kalender/screens/kalender_screen.dart`
- [Islamic event countdown](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/data/services/islamic_event_service.dart): `lib/data/services/islamic_event_service.dart`

### Islamic content

- [Quran reader](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/quran/screens/quran_detail_screen.dart): `lib/features/quran/screens/quran_detail_screen.dart`
- [Surah discovery](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/quran/screens/quran_list_screen.dart): `lib/features/quran/screens/quran_list_screen.dart`
- [Floating audio player](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/quran/widgets/audio_player_bar.dart): `lib/features/quran/widgets/audio_player_bar.dart`
- [Murottal playback](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/murottal/screens/murottal_screen.dart): `lib/features/murottal/screens/murottal_screen.dart`
- [Hadith library](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/hadits/screens/hadits_list_screen.dart): `lib/features/hadits/screens/hadits_list_screen.dart`
- [Daily duas](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/features/doa/screens/doa_list_screen.dart): `lib/features/doa/screens/doa_list_screen.dart`

### State and data

- [Hadith data service](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/data/services/hadits_service.dart): `lib/data/services/hadits_service.dart`
- [Doa data service](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/data/services/doa_service.dart): `lib/data/services/doa_service.dart`
- [Feature state](https://github.com/aldikurniawan19/ramadhanku/tree/main/lib/providers): `lib/providers`
- [Prayer data service](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/data/services/prayer_service.dart): `lib/data/services/prayer_service.dart`
- [Quran data service](https://github.com/aldikurniawan19/ramadhanku/blob/main/lib/data/services/quran_service.dart): `lib/data/services/quran_service.dart`

### Native playback

- [Adhan method channel](https://github.com/aldikurniawan19/ramadhanku/blob/main/android/app/src/main/kotlin/com/ramadhan/app/ramadhan_flutter/AdhanApplication.kt): `android/app/src/main/kotlin/com/ramadhan/app/ramadhan_flutter/AdhanApplication.kt`
- [Adhan broadcast receiver](https://github.com/aldikurniawan19/ramadhanku/blob/main/android/app/src/main/kotlin/com/ramadhan/app/ramadhan_flutter/AdhanBroadcastReceiver.kt): `android/app/src/main/kotlin/com/ramadhan/app/ramadhan_flutter/AdhanBroadcastReceiver.kt`
- [Android adhan service](https://github.com/aldikurniawan19/ramadhanku/blob/main/android/app/src/main/kotlin/com/ramadhan/app/ramadhan_flutter/AdhanPlayerService.kt): `android/app/src/main/kotlin/com/ramadhan/app/ramadhan_flutter/AdhanPlayerService.kt`

### Other components

- **App user**
- **Open Islamic APIs**

## Connections

- App user → Main navigation: opens app (evidence: `README.md`)
- Main navigation → Home dashboard: shows home (evidence: `README.md`)
- Main navigation → Login and registration: offers account access (evidence: `README.md`)
- Main navigation → Surah discovery: opens Quran (evidence: `README.md`)
- Surah discovery → Quran reader: opens surah (evidence: `README.md`)
- Quran reader → Floating audio player: plays recitation (evidence: `README.md`)
- Main navigation → Murottal playback: opens audio (evidence: `README.md`)
- Main navigation → Prayer schedule: opens schedule (evidence: `README.md`)
- Prayer schedule → Location detection: uses GPS location (evidence: `README.md`)
- Main navigation → Qibla compass: opens compass (evidence: `README.md`)
- Main navigation → Hadith library: opens hadith (evidence: `README.md`)
- Main navigation → Daily duas: opens duas (evidence: `README.md`)
- Main navigation → Hijri calendar: opens calendar (evidence: `README.md`)
- Hijri calendar → Islamic event countdown: shows countdowns (evidence: `README.md`)
- Open Islamic APIs → Quran data service: supplies Quran data (evidence: `README.md`)
- Open Islamic APIs → Hadith data service: supplies hadith data (evidence: `README.md`)
- Open Islamic APIs → Doa data service: supplies dua data (evidence: `README.md`)
- Open Islamic APIs → Prayer data service: supplies prayer data (evidence: `README.md`)
- Adhan method channel → Android adhan service: starts or stops (evidence: `android/app/src/main/kotlin/com/ramadhan/app/ramadhan_flutter/AdhanApplication.kt`)
- Adhan broadcast receiver → Android adhan service: starts or stops (evidence: `android/app/src/main/kotlin/com/ramadhan/app/ramadhan_flutter/AdhanBroadcastReceiver.kt`)
- Android adhan service → Adhan method channel: plays adhan for (evidence: `android/app/src/main/kotlin/com/ramadhan/app/ramadhan_flutter/AdhanApplication.kt`)
