# m4hmoud-atef/skoon-flutter-islamic-app architecture

> Architecture diagram of the GitHub repository m4hmoud-atef/skoon-flutter-islamic-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/m4hmoud-atef/skoon-flutter-islamic-app
- Repository: https://github.com/m4hmoud-atef/skoon-flutter-islamic-app

## Overview

Skoon is a Flutter Islamic-content and practice app. Its principal user workflow is to open the app, reach its home experience, and choose a feature such as reading Quran, browsing Hadith, or listening to recitation. The tree shows distinct feature areas for these capabilities and for supplications, prayer tools, and other content. Source excerpts are limited to native platform launchers, not the Dart runtime, so feature relationships below reflect README-documented capabilities; internal routing and data flows are not asserted.

Main entry points: [`lib/features/home.dart`](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/home.dart) (Home), [`lib/main.dart`](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/main.dart) (Flutter entry), [`lib/features/QuranPages/views/quranDetailsPage.dart`](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/QuranPages/views/quranDetailsPage.dart) (Quran reader), [`lib/features/audiopage/views/audio_home_page.dart`](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/audiopage/views/audio_home_page.dart) (Quran audio)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_quran["Quran and audio"]
  node_quran_reader["Quran reader"]
  node_sura_list["Surah list"]
  node_quran_audio["Quran audio"]
  node_reciter_surahs["Reciter surahs"]
end

subgraph group_knowledge["Islamic learning"]
  node_hadith["Hadith books<br/>[booklistpage.dart]"]
  node_hadith_detail["Hadith details"]
  node_allah_names["Allah names"]
end

subgraph group_practice["Daily practice"]
  node_azkar["Duaa and azkar"]
  node_zikr_detail["Zikr details"]
  node_qibla["Qibla compass<br/>[qibla_page.dart]"]
  node_sibha["Tasbih counter<br/>[sibha_page.dart]"]
  node_calendar["Calendar<br/>[calender.dart]"]
end

subgraph group_app["App experience"]
  node_entry["Flutter entry<br/>[main.dart]"]
  node_home["Home<br/>[home.dart]"]
  node_radio["Islamic radio<br/>[radio_page.dart]"]
  node_live_tv["Live TV<br/>[live_tv_page.dart]"]
  node_notifications["Notifications"]
end

node_user(("User"))

node_user -->|"opens app"| node_entry
node_entry -.->|"starts experience"| node_home
node_home -->|"offers Quran"| node_quran_reader
node_home -->|"offers recitations"| node_quran_audio
node_home -->|"offers Hadith"| node_hadith
node_home -->|"offers names"| node_allah_names
node_home -->|"offers supplications"| node_azkar
node_home -->|"offers radio"| node_radio
node_home -.->|"offers practice tools"| node_qibla
node_home -.->|"offers practice tools"| node_sibha
node_home -.->|"offers more features"| node_calendar
node_home -.->|"offers more features"| node_live_tv
node_home -.->|"offers more features"| node_notifications

click node_entry "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/main.dart"
click node_home "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/home.dart"
click node_quran_reader "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/QuranPages/views/quranDetailsPage.dart"
click node_sura_list "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/QuranPages/views/quran_sura_list.dart"
click node_quran_audio "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/audiopage/views/audio_home_page.dart"
click node_reciter_surahs "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/audiopage/views/reciter_all_surahs_page.dart"
click node_hadith "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/hadith/views/booklistpage.dart"
click node_hadith_detail "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/hadith/views/hadithdetailspage.dart"
click node_allah_names "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/allah_names/allah_names_page.dart"
click node_azkar "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/azkar/views/azkar_homepage.dart"
click node_zikr_detail "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/azkar/views/zikr_detailspage.dart"
click node_qibla "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/qibla/qibla_page.dart"
click node_sibha "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/sibha/sibha_page.dart"
click node_calendar "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/calender/calender.dart"
click node_radio "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/radio_page/radio_page.dart"
click node_live_tv "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/live_tv/live_tv_page.dart"
click node_notifications "https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/notifications/views/all_notification_page.dart"

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_quran_reader,node_sura_list,node_quran_audio,node_reciter_surahs,node_user toneBlue
class node_hadith,node_hadith_detail,node_allah_names toneAmber
class node_azkar,node_zikr_detail,node_qibla,node_sibha,node_calendar toneMint
class node_entry,node_home,node_radio,node_live_tv,node_notifications toneRose
```

## Components

### Quran and audio

- [Quran reader](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/QuranPages/views/quranDetailsPage.dart): `lib/features/QuranPages/views/quranDetailsPage.dart`
- [Surah list](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/QuranPages/views/quran_sura_list.dart): `lib/features/QuranPages/views/quran_sura_list.dart`
- [Quran audio](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/audiopage/views/audio_home_page.dart): `lib/features/audiopage/views/audio_home_page.dart`
- [Reciter surahs](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/audiopage/views/reciter_all_surahs_page.dart): `lib/features/audiopage/views/reciter_all_surahs_page.dart`

### Islamic learning

- [Hadith books](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/hadith/views/booklistpage.dart): `lib/features/hadith/views/booklistpage.dart`
- [Hadith details](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/hadith/views/hadithdetailspage.dart): `lib/features/hadith/views/hadithdetailspage.dart`
- [Allah names](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/allah_names/allah_names_page.dart): `lib/features/allah_names/allah_names_page.dart`

### Daily practice

- [Duaa and azkar](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/azkar/views/azkar_homepage.dart): `lib/features/azkar/views/azkar_homepage.dart`
- [Zikr details](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/azkar/views/zikr_detailspage.dart): `lib/features/azkar/views/zikr_detailspage.dart`
- [Qibla compass](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/qibla/qibla_page.dart): `lib/features/qibla/qibla_page.dart`
- [Tasbih counter](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/sibha/sibha_page.dart): `lib/features/sibha/sibha_page.dart`
- [Calendar](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/calender/calender.dart): `lib/features/calender/calender.dart`

### App experience

- [Flutter entry](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/main.dart): `lib/main.dart`
- [Home](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/home.dart): `lib/features/home.dart`
- [Islamic radio](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/radio_page/radio_page.dart): `lib/features/radio_page/radio_page.dart`
- [Live TV](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/live_tv/live_tv_page.dart): `lib/features/live_tv/live_tv_page.dart`
- [Notifications](https://github.com/m4hmoud-atef/skoon-flutter-islamic-app/blob/main/lib/features/notifications/views/all_notification_page.dart): `lib/features/notifications/views/all_notification_page.dart`

### Other components

- **User**

## Connections

- User → Flutter entry: opens app (evidence: `README.md`)
- Flutter entry → Home: starts experience
- Home → Quran reader: offers Quran (evidence: `README.md`)
- Home → Quran audio: offers recitations (evidence: `README.md`)
- Home → Hadith books: offers Hadith (evidence: `README.md`)
- Home → Allah names: offers names (evidence: `README.md`)
- Home → Duaa and azkar: offers supplications (evidence: `README.md`)
- Home → Islamic radio: offers radio (evidence: `README.md`)
- Home → Qibla compass: offers practice tools
- Home → Tasbih counter: offers practice tools
- Home → Calendar: offers more features
- Home → Live TV: offers more features
- Home → Notifications: offers more features
