# fistonuzabumwana/gospel_hub architecture

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

- Interactive diagram: https://gitdiagram.com/fistonuzabumwana/gospel_hub
- Repository: https://github.com/fistonuzabumwana/gospel_hub

## Overview

Gospel Hub is an offline Flutter Bible-reading and hymn application. The main user journey is to open the app, read a Bible chapter or browse hymn lyrics, and use search or saved study features to resume and organize content. The README documents parallel translations, narration, notes and tags, setlists, devotion statistics, and JSON backup. Dart implementation details were not included, so those feature links are documented product relationships rather than verified internal calls; the Android widget links follow the sampled native source.

Main entry points: [`lib/screens`](https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/screens) (Bible reader), [`lib`](https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib) (Flutter app), [`lib/services`](https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/services) (Backup and restore), [`android/app/src/main/java/com/gospelhub/app/gospel_hub/MainActivity.java`](https://github.com/fistonuzabumwana/gospel_hub/blob/master/android/app/src/main/java/com/gospelhub/app/gospel_hub/MainActivity.java) (Android widget channel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_flutter["Flutter app"]
  node_dashboard["Dashboard"]
  node_search["Search"]
  node_backup["Backup and restore"]
end

subgraph group_scripture["Bible study"]
  node_bible_reader["Bible reader"]
  node_translations["Bible translations"]
  node_study["Study notes and tags"]
  node_narration["Voice narration"]
end

subgraph group_music["Hymns"]
  node_hymn_library["Hymn library"]
  node_hymn_data["Hymn content"]
  node_setlists["Hymn setlists"]
end

subgraph group_platform["Platform and data"]
  node_database[("Offline SQLite")]
  node_android_channel["Android widget channel<br/>[MainActivity.java]"]
  node_android_widget["Bible home widget"]
end

node_reader(("Gospel Hub user"))

node_reader -->|"opens"| node_flutter
node_flutter -.->|"shows"| node_dashboard
node_dashboard -->|"resumes reading"| node_bible_reader
node_reader -->|"reads chapters"| node_bible_reader
node_bible_reader -->|"displays translations"| node_translations
node_bible_reader -->|"requests narration"| node_narration
node_bible_reader -->|"saves study items"| node_study
node_reader -->|"browses hymns"| node_hymn_library
node_hymn_library -->|"presents lyrics"| node_hymn_data
node_hymn_library -->|"organizes songs"| node_setlists
node_reader -->|"searches content"| node_search
node_search -->|"searches indexed content"| node_database
node_reader -->|"exports or restores"| node_backup
node_backup -.->|"backs up saved data"| node_database
node_android_channel -->|"updates widget"| node_android_widget
node_android_widget -->|"opens app"| node_android_channel

click node_flutter "https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib"
click node_dashboard "https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/screens"
click node_search "https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/screens"
click node_bible_reader "https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/screens"
click node_translations "https://github.com/fistonuzabumwana/gospel_hub/tree/master/assets/bible"
click node_study "https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/widgets/saved"
click node_narration "https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/services"
click node_hymn_library "https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/screens"
click node_hymn_data "https://github.com/fistonuzabumwana/gospel_hub/tree/master/assets/hymns"
click node_setlists "https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/widgets/saved"
click node_backup "https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/services"
click node_database "https://github.com/fistonuzabumwana/gospel_hub/tree/master/assets/database"
click node_android_channel "https://github.com/fistonuzabumwana/gospel_hub/blob/master/android/app/src/main/java/com/gospelhub/app/gospel_hub/MainActivity.java"
click node_android_widget "https://github.com/fistonuzabumwana/gospel_hub/blob/master/android/app/src/main/java/com/gospelhub/app/gospel_hub/BibleWidgetProvider.java"

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_flutter,node_dashboard,node_search,node_backup,node_reader toneBlue
class node_bible_reader,node_translations,node_study,node_narration toneAmber
class node_hymn_library,node_hymn_data,node_setlists toneMint
class node_database,node_android_channel,node_android_widget toneRose
```

## Components

### App experience

- [Flutter app](https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib): `lib`
- [Dashboard](https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/screens): `lib/screens`
- [Search](https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/screens): `lib/screens`
- [Backup and restore](https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/services): `lib/services`

### Bible study

- [Bible reader](https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/screens): `lib/screens`
- [Bible translations](https://github.com/fistonuzabumwana/gospel_hub/tree/master/assets/bible): `assets/bible`
- [Study notes and tags](https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/widgets/saved): `lib/widgets/saved`
- [Voice narration](https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/services): `lib/services`

### Hymns

- [Hymn library](https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/screens): `lib/screens`
- [Hymn content](https://github.com/fistonuzabumwana/gospel_hub/tree/master/assets/hymns): `assets/hymns`
- [Hymn setlists](https://github.com/fistonuzabumwana/gospel_hub/tree/master/lib/widgets/saved): `lib/widgets/saved`

### Platform and data

- [Offline SQLite](https://github.com/fistonuzabumwana/gospel_hub/tree/master/assets/database): `assets/database`
- [Android widget channel](https://github.com/fistonuzabumwana/gospel_hub/blob/master/android/app/src/main/java/com/gospelhub/app/gospel_hub/MainActivity.java): `android/app/src/main/java/com/gospelhub/app/gospel_hub/MainActivity.java`
- [Bible home widget](https://github.com/fistonuzabumwana/gospel_hub/blob/master/android/app/src/main/java/com/gospelhub/app/gospel_hub/BibleWidgetProvider.java): `android/app/src/main/java/com/gospelhub/app/gospel_hub/BibleWidgetProvider.java`

### Other components

- **Gospel Hub user**

## Connections

- Gospel Hub user → Flutter app: opens (evidence: `README.md`)
- Flutter app → Dashboard: shows
- Dashboard → Bible reader: resumes reading (evidence: `README.md`)
- Gospel Hub user → Bible reader: reads chapters (evidence: `README.md`)
- Bible reader → Bible translations: displays translations (evidence: `README.md`)
- Bible reader → Voice narration: requests narration (evidence: `README.md`)
- Bible reader → Study notes and tags: saves study items (evidence: `README.md`)
- Gospel Hub user → Hymn library: browses hymns (evidence: `README.md`)
- Hymn library → Hymn content: presents lyrics (evidence: `README.md`)
- Hymn library → Hymn setlists: organizes songs (evidence: `README.md`)
- Gospel Hub user → Search: searches content (evidence: `README.md`)
- Search → Offline SQLite: searches indexed content (evidence: `README.md`)
- Gospel Hub user → Backup and restore: exports or restores (evidence: `README.md`)
- Backup and restore → Offline SQLite: backs up saved data
- Android widget channel → Bible home widget: updates widget (evidence: `android/app/src/main/java/com/gospelhub/app/gospel_hub/MainActivity.java`)
- Bible home widget → Android widget channel: opens app (evidence: `android/app/src/main/java/com/gospelhub/app/gospel_hub/BibleWidgetProvider.java`)
