# mrfanasina/baiboly architecture

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

- Interactive diagram: https://gitdiagram.com/mrfanasina/baiboly
- Repository: https://github.com/mrfanasina/baiboly

## Overview

Baiboly is an offline-oriented Malagasy Bible study and worship Android app. Users enter through the app shell, then read and search scripture, study verses with AI, or use worship, notes, devotional, and sharing features. Its domain services mediate between screens and local repositories or stores, with selected online integrations. The graph preserves README-documented capabilities; for unsampled modules, links are included only when the README or SOURCE INDEX supports them.

Main entry points: [`app/src/main/java/com/fa/baiboly/MainActivity.java`](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/MainActivity.java) (App navigation), [`app/src/main/java/com/fa/baiboly/data/search/GlobalSearchService.java`](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/search/GlobalSearchService.java) (Search orchestration), [`app/src/main/java/com/fa/baiboly/ui/verses/VersesActivity.java`](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/ui/verses/VersesActivity.java) (Bible reader), [`app/src/main/java/com/fa/baiboly/data/ai/BibleExplanationService.java`](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/ai/BibleExplanationService.java) (Explanation service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_main["App navigation<br/>[MainActivity.java]"]
  node_settings["Settings"]
  node_colors["Theme colors<br/>[ColorManager.java]"]
end

subgraph group_study["Scripture study"]
  node_reader["Bible reader"]
  node_biblesvc["Bible service<br/>[BibleService.java]"]
  node_biblerepo["Bible repository"]
  node_refparser["Reference parsing"]
  node_searchui["Global search"]
  node_searchsvc["Search orchestration"]
  node_aiui["AI explanation chat"]
  node_aisvc["Explanation service"]
  node_aiprefs["AI preferences"]
  node_gemini["Gemini client<br/>[GeminiClient.java]"]
  node_bookmodel["Book model<br/>[Book.java]"]
end

subgraph group_worship["Worship and devotion"]
  node_songs["Song service"]
  node_songui["Song detail"]
  node_playservice["Audio playback"]
  node_playmanager["Playback manager"]
  node_playstore[("Playback state<br/>[PlaybackStore.java]")]
  node_programs["Worship programs"]
  node_mofonaina["Daily devotion"]
  node_scraper["Online devotion"]
  node_fanekena["Fanekena service"]
end

subgraph group_personal["Personal data"]
  node_notesui["Notes editor"]
  node_notesvc["Notes service<br/>[NoteService.java]"]
  node_richtext["Rich text codec<br/>[RichTextCodec.java]"]
  node_history["Reading history"]
  node_database[("Local database")]
end

subgraph group_tools["Sharing and utilities"]
  node_downloadui["Download center"]
  node_manifest["Server catalog"]
  node_transferui["Device transfer"]
  node_transfer["Transfer client"]
end

node_user(("Reader"))
node_geminiapi{{"Google Gemini"}}

node_user -->|"opens app"| node_main
node_main -->|"opens reader"| node_reader
node_main -->|"opens search"| node_searchui
node_main -->|"opens songs"| node_songui
node_main -->|"opens chat"| node_aiui
node_main -->|"opens transfer"| node_transferui
node_main -->|"opens downloads"| node_downloadui
node_main -->|"opens settings"| node_settings
node_reader -.->|"loads scripture"| node_biblesvc
node_biblesvc -->|"queries verses"| node_biblerepo
node_reader -.->|"parses references"| node_refparser
node_searchui -->|"runs search"| node_searchsvc
node_searchsvc -->|"searches verses"| node_biblesvc
node_searchsvc -->|"searches songs"| node_songs
node_searchsvc -->|"searches content"| node_fanekena
node_aiui -.->|"requests explanation"| node_aisvc
node_aisvc -->|"requests response"| node_gemini
node_aisvc -->|"reads preferences"| node_aiprefs
node_gemini -.->|"calls API"| node_geminiapi
node_songui -.->|"loads songs"| node_songs
node_songui -->|"controls playback"| node_playservice
node_playmanager -->|"persists state"| node_playstore
node_programs -->|"stores programs"| node_database
node_mofonaina -.->|"fetches online"| node_scraper
node_notesui -.->|"edits notes"| node_notesvc
node_notesvc -->|"encodes text"| node_richtext
node_notesvc -.->|"stores notes"| node_database
node_history -.->|"stores history"| node_database
node_downloadui -.->|"loads catalog"| node_manifest
node_transferui -->|"transfers data"| node_transfer

click node_main "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/MainActivity.java"
click node_settings "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/SettingsFragment.java"
click node_colors "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/ColorManager.java"
click node_reader "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/ui/verses/VersesActivity.java"
click node_biblesvc "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/bible/BibleService.java"
click node_biblerepo "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/bible/BibleRepository.java"
click node_refparser "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/parser/BibleRefParser.java"
click node_searchui "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/ui/search/SearchActivity.java"
click node_searchsvc "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/search/GlobalSearchService.java"
click node_aiui "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/ui/ai/AiExplanationActivity.java"
click node_aisvc "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/ai/BibleExplanationService.java"
click node_aiprefs "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/ai/AiPreferencesService.java"
click node_gemini "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/ai/GeminiClient.java"
click node_songs "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/fihirana/FihiranaService.java"
click node_songui "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/ui/fihirana/SongDetailActivity.java"
click node_playservice "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/playback/PlaybackService.java"
click node_playmanager "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/playback/PlaybackManager.java"
click node_playstore "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/playback/PlaybackStore.java"
click node_programs "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/fandaharana/FandaharanaService.java"
click node_mofonaina "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/MofonainaRepository.java"
click node_scraper "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/scraper/MofonainaScraper.java"
click node_fanekena "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/fanekena/FanekenaService.java"
click node_notesui "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/ui/notes/NoteEditorActivity.java"
click node_notesvc "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/notes/NoteService.java"
click node_richtext "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/notes/richtext/RichTextCodec.java"
click node_history "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/history/HistoryRepository.java"
click node_database "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/DatabaseHelper.java"
click node_downloadui "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/ui/download/DownloadCenterActivity.java"
click node_manifest "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/download/ServerManifestClient.java"
click node_transferui "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/ui/transfer/TransferActivity.java"
click node_transfer "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/transfer/TransferClient.java"
click node_bookmodel "https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/models/Book.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_main,node_settings,node_colors toneBlue
class node_reader,node_biblesvc,node_biblerepo,node_refparser,node_searchui,node_searchsvc,node_aiui,node_aisvc,node_aiprefs,node_gemini,node_bookmodel toneAmber
class node_songs,node_songui,node_playservice,node_playmanager,node_playstore,node_programs,node_mofonaina,node_scraper,node_fanekena toneMint
class node_notesui,node_notesvc,node_richtext,node_history,node_database toneRose
class node_downloadui,node_manifest,node_transferui,node_transfer,node_user,node_geminiapi toneIndigo
```

## Components

### App shell

- [App navigation](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/MainActivity.java): `app/src/main/java/com/fa/baiboly/MainActivity.java`
- [Settings](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/SettingsFragment.java): `app/src/main/java/com/fa/baiboly/SettingsFragment.java`
- [Theme colors](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/ColorManager.java): `app/src/main/java/com/fa/baiboly/data/ColorManager.java`

### Scripture study

- [Bible reader](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/ui/verses/VersesActivity.java): `app/src/main/java/com/fa/baiboly/ui/verses/VersesActivity.java`
- [Bible service](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/bible/BibleService.java): `app/src/main/java/com/fa/baiboly/data/bible/BibleService.java`
- [Bible repository](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/bible/BibleRepository.java): `app/src/main/java/com/fa/baiboly/data/bible/BibleRepository.java`
- [Reference parsing](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/parser/BibleRefParser.java): `app/src/main/java/com/fa/baiboly/data/parser/BibleRefParser.java`
- [Global search](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/ui/search/SearchActivity.java): `app/src/main/java/com/fa/baiboly/ui/search/SearchActivity.java`
- [Search orchestration](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/search/GlobalSearchService.java): `app/src/main/java/com/fa/baiboly/data/search/GlobalSearchService.java`
- [AI explanation chat](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/ui/ai/AiExplanationActivity.java): `app/src/main/java/com/fa/baiboly/ui/ai/AiExplanationActivity.java`
- [Explanation service](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/ai/BibleExplanationService.java): `app/src/main/java/com/fa/baiboly/data/ai/BibleExplanationService.java`
- [AI preferences](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/ai/AiPreferencesService.java): `app/src/main/java/com/fa/baiboly/data/ai/AiPreferencesService.java`
- [Gemini client](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/ai/GeminiClient.java): `app/src/main/java/com/fa/baiboly/data/ai/GeminiClient.java`
- [Book model](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/models/Book.java): `app/src/main/java/com/fa/baiboly/models/Book.java`

### Worship and devotion

- [Song service](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/fihirana/FihiranaService.java): `app/src/main/java/com/fa/baiboly/data/fihirana/FihiranaService.java`
- [Song detail](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/ui/fihirana/SongDetailActivity.java): `app/src/main/java/com/fa/baiboly/ui/fihirana/SongDetailActivity.java`
- [Audio playback](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/playback/PlaybackService.java): `app/src/main/java/com/fa/baiboly/data/playback/PlaybackService.java`
- [Playback manager](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/playback/PlaybackManager.java): `app/src/main/java/com/fa/baiboly/data/playback/PlaybackManager.java`
- [Playback state](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/playback/PlaybackStore.java): `app/src/main/java/com/fa/baiboly/data/playback/PlaybackStore.java`
- [Worship programs](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/fandaharana/FandaharanaService.java): `app/src/main/java/com/fa/baiboly/data/fandaharana/FandaharanaService.java`
- [Daily devotion](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/MofonainaRepository.java): `app/src/main/java/com/fa/baiboly/data/MofonainaRepository.java`
- [Online devotion](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/scraper/MofonainaScraper.java): `app/src/main/java/com/fa/baiboly/data/scraper/MofonainaScraper.java`
- [Fanekena service](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/fanekena/FanekenaService.java): `app/src/main/java/com/fa/baiboly/data/fanekena/FanekenaService.java`

### Personal data

- [Notes editor](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/ui/notes/NoteEditorActivity.java): `app/src/main/java/com/fa/baiboly/ui/notes/NoteEditorActivity.java`
- [Notes service](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/notes/NoteService.java): `app/src/main/java/com/fa/baiboly/data/notes/NoteService.java`
- [Rich text codec](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/notes/richtext/RichTextCodec.java): `app/src/main/java/com/fa/baiboly/data/notes/richtext/RichTextCodec.java`
- [Reading history](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/history/HistoryRepository.java): `app/src/main/java/com/fa/baiboly/data/history/HistoryRepository.java`
- [Local database](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/DatabaseHelper.java): `app/src/main/java/com/fa/baiboly/data/DatabaseHelper.java`

### Sharing and utilities

- [Download center](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/ui/download/DownloadCenterActivity.java): `app/src/main/java/com/fa/baiboly/ui/download/DownloadCenterActivity.java`
- [Server catalog](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/download/ServerManifestClient.java): `app/src/main/java/com/fa/baiboly/data/download/ServerManifestClient.java`
- [Device transfer](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/ui/transfer/TransferActivity.java): `app/src/main/java/com/fa/baiboly/ui/transfer/TransferActivity.java`
- [Transfer client](https://github.com/mrfanasina/baiboly/blob/main/app/src/main/java/com/fa/baiboly/data/transfer/TransferClient.java): `app/src/main/java/com/fa/baiboly/data/transfer/TransferClient.java`

### Other components

- **Reader**
- **Google Gemini**

## Connections

- Reader → App navigation: opens app
- App navigation → Bible reader: opens reader (evidence: `app/src/main/java/com/fa/baiboly/MainActivity.java`)
- App navigation → Global search: opens search (evidence: `app/src/main/java/com/fa/baiboly/MainActivity.java`)
- App navigation → Song detail: opens songs (evidence: `app/src/main/java/com/fa/baiboly/MainActivity.java`)
- App navigation → AI explanation chat: opens chat (evidence: `app/src/main/java/com/fa/baiboly/MainActivity.java`)
- App navigation → Device transfer: opens transfer (evidence: `app/src/main/java/com/fa/baiboly/MainActivity.java`)
- App navigation → Download center: opens downloads (evidence: `app/src/main/java/com/fa/baiboly/MainActivity.java`)
- App navigation → Settings: opens settings (evidence: `app/src/main/java/com/fa/baiboly/MainActivity.java`)
- Bible reader → Bible service: loads scripture (evidence: `app/src/main/java/com/fa/baiboly/ui/verses/VersesActivity.java`)
- Bible service → Bible repository: queries verses (evidence: `app/src/main/java/com/fa/baiboly/data/bible/BibleService.java`)
- Bible reader → Reference parsing: parses references (evidence: `app/src/main/java/com/fa/baiboly/ui/verses/VersesActivity.java`)
- Global search → Search orchestration: runs search (evidence: `app/src/main/java/com/fa/baiboly/ui/search/SearchActivity.java`)
- Search orchestration → Bible service: searches verses (evidence: `app/src/main/java/com/fa/baiboly/data/search/GlobalSearchService.java`)
- Search orchestration → Song service: searches songs (evidence: `app/src/main/java/com/fa/baiboly/data/search/GlobalSearchService.java`)
- Search orchestration → Fanekena service: searches content (evidence: `app/src/main/java/com/fa/baiboly/data/search/GlobalSearchService.java`)
- AI explanation chat → Explanation service: requests explanation (evidence: `app/src/main/java/com/fa/baiboly/ui/ai/AiExplanationActivity.java`)
- Explanation service → Gemini client: requests response (evidence: `app/src/main/java/com/fa/baiboly/data/ai/BibleExplanationService.java`)
- Explanation service → AI preferences: reads preferences (evidence: `app/src/main/java/com/fa/baiboly/data/ai/BibleExplanationService.java`)
- Gemini client → Google Gemini: calls API
- Song detail → Song service: loads songs (evidence: `app/src/main/java/com/fa/baiboly/ui/fihirana/SongDetailActivity.java`)
- Song detail → Audio playback: controls playback (evidence: `app/src/main/java/com/fa/baiboly/data/playback/PlaybackService.java`)
- Playback manager → Playback state: persists state (evidence: `app/src/main/java/com/fa/baiboly/data/playback/PlaybackManager.java`)
- Worship programs → Local database: stores programs (evidence: `app/src/main/java/com/fa/baiboly/data/fandaharana/FandaharanaService.java`)
- Daily devotion → Online devotion: fetches online
- Notes editor → Notes service: edits notes
- Notes service → Rich text codec: encodes text (evidence: `app/src/main/java/com/fa/baiboly/data/notes/NoteService.java`)
- Notes service → Local database: stores notes
- Reading history → Local database: stores history
- Download center → Server catalog: loads catalog (evidence: `app/src/main/java/com/fa/baiboly/ui/download/DownloadCenterActivity.java`)
- Device transfer → Transfer client: transfers data (evidence: `app/src/main/java/com/fa/baiboly/ui/transfer/TransferActivity.java`)
