# korya0/sana architecture

> Architecture diagram of the GitHub repository korya0/sana, 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/korya0/sana
- Repository: https://github.com/korya0/sana

## Overview

Sana is a Flutter Islamic companion whose user-facing features cover prayer schedules, Quran, worship references, learning, and location-aware tools. The README documents feature behavior and selected integrations, but the supplied source excerpts are native platform/plugin files rather than Dart runtime code. The graph therefore preserves the documented product branches and explicit relationships while avoiding inferred calls between feature modules; directory paths identify unsampled feature implementations.

Main entry points: [`lib/features/prayer`](https://github.com/korya0/sana/tree/main/lib/features/prayer) (Prayer times), [`lib/features/home/presentation`](https://github.com/korya0/sana/tree/main/lib/features/home/presentation) (Home dashboard), [`lib/features/hadith_search`](https://github.com/korya0/sana/tree/main/lib/features/hadith_search) (Hadith search), [`lib/features/qibla`](https://github.com/korya0/sana/tree/main/lib/features/qibla) (Qibla compass)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_home["Home dashboard"]
  node_splash["Startup screen"]
  node_feedback["User feedback"]
  node_developer["Developer dashboard"]
end

subgraph group_worship["Worship tools"]
  node_prayer["Prayer times"]
  node_azkar["Azkar collection"]
  node_salat["Salat reminders"]
end

subgraph group_knowledge["Islamic knowledge"]
  node_quran["Quran reader"]
  node_hadith["Hadith search"]
  node_asma["99 Names"]
  node_teaching["Prayer learning"]
  node_daily["Daily content"]
end

subgraph group_location["Location services"]
  node_qibla["Qibla compass"]
  node_location_mgr["Location manager"]
end

subgraph group_platform["Shared services"]
  node_app_date["App date"]
  node_app_update["App updates"]
end

node_user(("App user"))
node_dorar{{"Dorar API"}}
node_firebase{{"Firebase Remote Config"}}
node_adhan{{"Adhan engine"}}

node_user -->|"uses"| node_home
node_user -->|"opens"| node_prayer
node_user -->|"reads"| node_quran
node_user -->|"uses"| node_azkar
node_user -->|"searches"| node_hadith
node_user -->|"checks direction"| node_qibla
node_user -->|"sets reminders"| node_salat
node_user -->|"learns prayer"| node_teaching
node_user -->|"views names"| node_asma
node_prayer -->|"uses location"| node_location_mgr
node_qibla -->|"uses location"| node_location_mgr
node_daily -->|"listens for date"| node_app_date
node_hadith -->|"queries"| node_dorar
node_app_update -->|"checks versions"| node_firebase
node_prayer -->|"calculates times"| node_adhan
node_home -->|"features name of day"| node_asma

click node_home "https://github.com/korya0/sana/tree/main/lib/features/home/presentation"
click node_splash "https://github.com/korya0/sana/tree/main/lib/features/splash/presentation"
click node_prayer "https://github.com/korya0/sana/tree/main/lib/features/prayer"
click node_azkar "https://github.com/korya0/sana/tree/main/lib/features/azkar"
click node_salat "https://github.com/korya0/sana/tree/main/lib/features/salat_ala_nabi"
click node_qibla "https://github.com/korya0/sana/tree/main/lib/features/qibla"
click node_quran "https://github.com/korya0/sana/tree/main/lib/features/quran"
click node_hadith "https://github.com/korya0/sana/tree/main/lib/features/hadith_search"
click node_asma "https://github.com/korya0/sana/tree/main/lib/features/asma_ul_husna"
click node_teaching "https://github.com/korya0/sana/tree/main/lib/features/teaching_prayer"
click node_daily "https://github.com/korya0/sana/tree/main/lib/features/daily_content"
click node_location_mgr "https://github.com/korya0/sana/tree/main/lib/core/services/location_manager"
click node_app_date "https://github.com/korya0/sana/tree/main/lib/core/services/app_date"
click node_app_update "https://github.com/korya0/sana/tree/main/lib/core/services/app_update"
click node_feedback "https://github.com/korya0/sana/tree/main/lib/features/feedback"
click node_developer "https://github.com/korya0/sana/tree/main/lib/features/developer_dashboard"

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_home,node_splash,node_feedback,node_developer,node_user toneBlue
class node_prayer,node_azkar,node_salat toneAmber
class node_quran,node_hadith,node_asma,node_teaching,node_daily,node_dorar toneMint
class node_qibla,node_location_mgr toneRose
class node_app_date,node_app_update,node_firebase,node_adhan toneIndigo
```

## Components

### App experience

- [Home dashboard](https://github.com/korya0/sana/tree/main/lib/features/home/presentation): `lib/features/home/presentation`
- [Startup screen](https://github.com/korya0/sana/tree/main/lib/features/splash/presentation): `lib/features/splash/presentation`
- [User feedback](https://github.com/korya0/sana/tree/main/lib/features/feedback): `lib/features/feedback`
- [Developer dashboard](https://github.com/korya0/sana/tree/main/lib/features/developer_dashboard): `lib/features/developer_dashboard`

### Worship tools

- [Prayer times](https://github.com/korya0/sana/tree/main/lib/features/prayer): `lib/features/prayer`
- [Azkar collection](https://github.com/korya0/sana/tree/main/lib/features/azkar): `lib/features/azkar`
- [Salat reminders](https://github.com/korya0/sana/tree/main/lib/features/salat_ala_nabi): `lib/features/salat_ala_nabi`

### Islamic knowledge

- [Quran reader](https://github.com/korya0/sana/tree/main/lib/features/quran): `lib/features/quran`
- [Hadith search](https://github.com/korya0/sana/tree/main/lib/features/hadith_search): `lib/features/hadith_search`
- [99 Names](https://github.com/korya0/sana/tree/main/lib/features/asma_ul_husna): `lib/features/asma_ul_husna`
- [Prayer learning](https://github.com/korya0/sana/tree/main/lib/features/teaching_prayer): `lib/features/teaching_prayer`
- [Daily content](https://github.com/korya0/sana/tree/main/lib/features/daily_content): `lib/features/daily_content`

### Location services

- [Qibla compass](https://github.com/korya0/sana/tree/main/lib/features/qibla): `lib/features/qibla`
- [Location manager](https://github.com/korya0/sana/tree/main/lib/core/services/location_manager): `lib/core/services/location_manager`

### Shared services

- [App date](https://github.com/korya0/sana/tree/main/lib/core/services/app_date): `lib/core/services/app_date`
- [App updates](https://github.com/korya0/sana/tree/main/lib/core/services/app_update): `lib/core/services/app_update`

### Other components

- **App user**
- **Dorar API**
- **Firebase Remote Config**
- **Adhan engine**

## Connections

- App user → Home dashboard: uses (evidence: `README.md`)
- App user → Prayer times: opens (evidence: `README.md`)
- App user → Quran reader: reads (evidence: `README.md`)
- App user → Azkar collection: uses (evidence: `README.md`)
- App user → Hadith search: searches (evidence: `README.md`)
- App user → Qibla compass: checks direction (evidence: `README.md`)
- App user → Salat reminders: sets reminders (evidence: `README.md`)
- App user → Prayer learning: learns prayer (evidence: `README.md`)
- App user → 99 Names: views names (evidence: `README.md`)
- Prayer times → Location manager: uses location (evidence: `README.md`)
- Qibla compass → Location manager: uses location (evidence: `README.md`)
- Daily content → App date: listens for date (evidence: `README.md`)
- Hadith search → Dorar API: queries (evidence: `README.md`)
- App updates → Firebase Remote Config: checks versions (evidence: `README.md`)
- Prayer times → Adhan engine: calculates times (evidence: `README.md`)
- Home dashboard → 99 Names: features name of day (evidence: `README.md`)
