# rohithmaka/bible-app architecture

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

- Interactive diagram: https://gitdiagram.com/rohithmaka/bible-app
- Repository: https://github.com/rohithmaka/bible-app

## Overview

This is an Expo mobile Bible and spiritual-growth app. The principal workflow begins with a reader choosing scripture and translation, then reading, searching, and saving verses; parallel experiences support daily devotion, prayer, reading plans, reminders, and community. The graph includes the documented-by-tree feature routes, but several are unsampled, so their internal interactions are not inferred. The README is an unmerged Expo starter template and does not establish product behavior.

Main entry points: [`src/app/(tabs)/bible.tsx`](https://github.com/rohithmaka/bible-app/blob/main/src/app/(tabs)/bible.tsx) (Bible reader), [`src/store/useBibleStore.ts`](https://github.com/rohithmaka/bible-app/blob/main/src/store/useBibleStore.ts) (Bible state), [`src/store/useSpiritualStore.ts`](https://github.com/rohithmaka/bible-app/blob/main/src/store/useSpiritualStore.ts) (Spiritual state), [`src/storage/storage.ts`](https://github.com/rohithmaka/bible-app/blob/main/src/storage/storage.ts) (Local storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experiences"]
  node_app["App routing<br/>[_layout.tsx]"]
  node_bible_ui["Bible reader<br/>[bible.tsx]"]
  node_search_ui["Bible search<br/>[bible-search.tsx]"]
  node_discovery["Discover and library<br/>[discover.tsx]"]
  node_study["Study workspace"]
  node_stories["Bible stories<br/>[stories.tsx]"]
  node_onboarding["Onboarding"]
  node_profile["Profile and settings<br/>[profile.tsx]"]
  node_auth_ui["Login<br/>[login.tsx]"]
end

subgraph group_scripture["Scripture and plans"]
  node_bible_engine["Bible engine<br/>[bibleEngine.ts]"]
  node_translation_catalog["Translation catalog"]
  node_bible_data["Bible text data<br/>[bibleData.ts]"]
  node_multi_bible["Multi-Bible service"]
  node_plan_ui["Reading planner"]
  node_plan_engine["Plan engine"]
end

subgraph group_spiritual["Spiritual practice"]
  node_devotion_ui["Daily devotion<br/>[daily-devotion.tsx]"]
  node_devotion_service["Devotion service"]
  node_devotion_content["Devotion content"]
  node_localized_devotions["Localized devotions"]
  node_prayer_ui["Prayer and circles<br/>[prayer.tsx]"]
  node_prayer_routes["Prayer circles<br/>[prayer-circles.tsx]"]
  node_reminder_ui["Reminders<br/>[reminders.tsx]"]
end

subgraph group_platform["State and services"]
  node_bible_store["Bible state<br/>[useBibleStore.ts]"]
  node_devotion_store["Devotion state"]
  node_spiritual_store["Spiritual state"]
  node_reminder_store["Reminder state"]
  node_notification_service["Reminder notifications"]
  node_auth_service["Authentication<br/>[authService.ts]"]
  node_supabase_config["Supabase client<br/>[supabaseConfig.ts]"]
  node_storage[("Local storage<br/>[storage.ts]")]
  node_cloud_sync["Cloud sync"]
  node_cloud_devotion_sync["Devotion sync"]
  node_analytics["Usage analytics"]
end

node_person(("App user"))

node_person -->|"opens"| node_app
node_app -.->|"routes to"| node_bible_ui
node_app -.->|"routes to"| node_onboarding
node_app -.->|"routes to"| node_auth_ui
node_bible_ui -->|"reads and updates"| node_bible_store
node_bible_ui -->|"uses"| node_bible_engine
node_bible_ui -->|"uses"| node_multi_bible
node_bible_ui -->|"uses"| node_translation_catalog
node_bible_ui -->|"reads and updates"| node_spiritual_store
node_search_ui -->|"reads and updates"| node_bible_store
node_search_ui -->|"searches with"| node_bible_engine
node_search_ui -->|"uses"| node_translation_catalog
node_bible_engine -->|"reads"| node_bible_data
node_bible_engine -->|"looks up"| node_translation_catalog
node_multi_bible -->|"uses"| node_bible_data
node_multi_bible -->|"uses"| node_translation_catalog
node_plan_ui -->|"uses"| node_plan_engine
node_plan_ui -->|"reads and updates"| node_bible_store
node_plan_ui -.->|"reads and updates"| node_spiritual_store
node_devotion_ui -.->|"uses"| node_devotion_store
node_devotion_store -->|"loads from"| node_devotion_service
node_devotion_store -->|"uses"| node_devotion_content
node_devotion_service -->|"reads"| node_devotion_content
node_devotion_content -->|"provides seed data"| node_localized_devotions
node_spiritual_store -->|"gets daily scripture"| node_localized_devotions
node_localized_devotions -->|"looks up"| node_translation_catalog
node_localized_devotions -->|"gets localized names"| node_bible_engine
node_prayer_ui -->|"reads and updates"| node_spiritual_store
node_prayer_ui -->|"uses"| node_cloud_sync
node_prayer_ui -->|"uses"| node_cloud_sync
node_prayer_ui -->|"reads and updates"| node_bible_store
node_prayer_routes -.->|"uses"| node_spiritual_store
node_reminder_ui -->|"reads and updates"| node_reminder_store
node_reminder_store -->|"schedules and cancels"| node_notification_service
node_auth_ui -.->|"uses"| node_auth_service
node_onboarding -->|"uses"| node_auth_service
node_onboarding -->|"uses"| node_supabase_config
node_auth_service -->|"authenticates with"| node_supabase_config
node_auth_service -->|"reads and writes"| node_storage
node_supabase_config -->|"persists sessions"| node_storage
node_bible_store -->|"persists"| node_storage
node_bible_store -->|"syncs planner progress"| node_cloud_devotion_sync
node_reminder_store -->|"persists"| node_storage
node_spiritual_store -->|"persists"| node_storage
node_devotion_store -->|"persists"| node_storage
node_cloud_sync -->|"uses"| node_supabase_config
node_cloud_devotion_sync -->|"uses"| node_supabase_config
node_devotion_store -->|"uses"| node_analytics

click node_app "https://github.com/rohithmaka/bible-app/blob/main/src/app/_layout.tsx"
click node_bible_ui "https://github.com/rohithmaka/bible-app/blob/main/src/app/(tabs)/bible.tsx"
click node_search_ui "https://github.com/rohithmaka/bible-app/blob/main/src/app/bible-search.tsx"
click node_discovery "https://github.com/rohithmaka/bible-app/blob/main/src/app/(tabs)/discover.tsx"
click node_study "https://github.com/rohithmaka/bible-app/blob/main/src/app/study-workspace.tsx"
click node_stories "https://github.com/rohithmaka/bible-app/blob/main/src/app/stories.tsx"
click node_onboarding "https://github.com/rohithmaka/bible-app/blob/main/src/app/onboarding-flow.tsx"
click node_profile "https://github.com/rohithmaka/bible-app/blob/main/src/app/(tabs)/profile.tsx"
click node_bible_store "https://github.com/rohithmaka/bible-app/blob/main/src/store/useBibleStore.ts"
click node_bible_engine "https://github.com/rohithmaka/bible-app/blob/main/src/engine/bibleEngine.ts"
click node_translation_catalog "https://github.com/rohithmaka/bible-app/blob/main/src/engine/translationCatalog.ts"
click node_bible_data "https://github.com/rohithmaka/bible-app/blob/main/src/data/bibleData.ts"
click node_multi_bible "https://github.com/rohithmaka/bible-app/blob/main/src/engine/multiBibleService.ts"
click node_plan_ui "https://github.com/rohithmaka/bible-app/blob/main/src/app/one-year-planner.tsx"
click node_plan_engine "https://github.com/rohithmaka/bible-app/blob/main/src/engine/oneYearPlanEngine.ts"
click node_devotion_ui "https://github.com/rohithmaka/bible-app/blob/main/src/app/daily-devotion.tsx"
click node_devotion_store "https://github.com/rohithmaka/bible-app/blob/main/src/store/useDevotionStore.ts"
click node_devotion_service "https://github.com/rohithmaka/bible-app/blob/main/src/services/dailyDevotionService.ts"
click node_devotion_content "https://github.com/rohithmaka/bible-app/blob/main/src/data/dailyDevotionsSeed.ts"
click node_localized_devotions "https://github.com/rohithmaka/bible-app/blob/main/src/data/multilingualDevotions.ts"
click node_prayer_ui "https://github.com/rohithmaka/bible-app/blob/main/src/app/(tabs)/prayer.tsx"
click node_prayer_routes "https://github.com/rohithmaka/bible-app/blob/main/src/app/prayer-circles.tsx"
click node_spiritual_store "https://github.com/rohithmaka/bible-app/blob/main/src/store/useSpiritualStore.ts"
click node_reminder_ui "https://github.com/rohithmaka/bible-app/blob/main/src/app/reminders.tsx"
click node_reminder_store "https://github.com/rohithmaka/bible-app/blob/main/src/store/useReminderStore.ts"
click node_notification_service "https://github.com/rohithmaka/bible-app/blob/main/src/services/reminderNotificationService.ts"
click node_auth_ui "https://github.com/rohithmaka/bible-app/blob/main/src/app/login.tsx"
click node_auth_service "https://github.com/rohithmaka/bible-app/blob/main/src/services/authService.ts"
click node_supabase_config "https://github.com/rohithmaka/bible-app/blob/main/src/services/supabaseConfig.ts"
click node_storage "https://github.com/rohithmaka/bible-app/blob/main/src/storage/storage.ts"
click node_cloud_sync "https://github.com/rohithmaka/bible-app/blob/main/src/services/supabaseSyncService.ts"
click node_cloud_devotion_sync "https://github.com/rohithmaka/bible-app/blob/main/src/services/cloudDevotionalSyncService.ts"
click node_analytics "https://github.com/rohithmaka/bible-app/blob/main/src/services/analyticsService.ts"

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_app,node_bible_ui,node_search_ui,node_discovery,node_study,node_stories,node_onboarding,node_profile,node_auth_ui,node_person toneBlue
class node_bible_engine,node_translation_catalog,node_bible_data,node_multi_bible,node_plan_ui,node_plan_engine toneAmber
class node_devotion_ui,node_devotion_service,node_devotion_content,node_localized_devotions,node_prayer_ui,node_prayer_routes,node_reminder_ui toneMint
class node_bible_store,node_devotion_store,node_spiritual_store,node_reminder_store,node_notification_service,node_auth_service,node_supabase_config,node_storage,node_cloud_sync,node_cloud_devotion_sync,node_analytics toneRose
```

## Components

### App experiences

- [App routing](https://github.com/rohithmaka/bible-app/blob/main/src/app/_layout.tsx): `src/app/_layout.tsx`
- [Bible reader](https://github.com/rohithmaka/bible-app/blob/main/src/app/(tabs)/bible.tsx): `src/app/(tabs)/bible.tsx`
- [Bible search](https://github.com/rohithmaka/bible-app/blob/main/src/app/bible-search.tsx): `src/app/bible-search.tsx`
- [Discover and library](https://github.com/rohithmaka/bible-app/blob/main/src/app/(tabs)/discover.tsx): `src/app/(tabs)/discover.tsx`
- [Study workspace](https://github.com/rohithmaka/bible-app/blob/main/src/app/study-workspace.tsx): `src/app/study-workspace.tsx`
- [Bible stories](https://github.com/rohithmaka/bible-app/blob/main/src/app/stories.tsx): `src/app/stories.tsx`
- [Onboarding](https://github.com/rohithmaka/bible-app/blob/main/src/app/onboarding-flow.tsx): `src/app/onboarding-flow.tsx`
- [Profile and settings](https://github.com/rohithmaka/bible-app/blob/main/src/app/(tabs)/profile.tsx): `src/app/(tabs)/profile.tsx`
- [Login](https://github.com/rohithmaka/bible-app/blob/main/src/app/login.tsx): `src/app/login.tsx`

### Scripture and plans

- [Bible engine](https://github.com/rohithmaka/bible-app/blob/main/src/engine/bibleEngine.ts): `src/engine/bibleEngine.ts`
- [Translation catalog](https://github.com/rohithmaka/bible-app/blob/main/src/engine/translationCatalog.ts): `src/engine/translationCatalog.ts`
- [Bible text data](https://github.com/rohithmaka/bible-app/blob/main/src/data/bibleData.ts): `src/data/bibleData.ts`
- [Multi-Bible service](https://github.com/rohithmaka/bible-app/blob/main/src/engine/multiBibleService.ts): `src/engine/multiBibleService.ts`
- [Reading planner](https://github.com/rohithmaka/bible-app/blob/main/src/app/one-year-planner.tsx): `src/app/one-year-planner.tsx`
- [Plan engine](https://github.com/rohithmaka/bible-app/blob/main/src/engine/oneYearPlanEngine.ts): `src/engine/oneYearPlanEngine.ts`

### Spiritual practice

- [Daily devotion](https://github.com/rohithmaka/bible-app/blob/main/src/app/daily-devotion.tsx): `src/app/daily-devotion.tsx`
- [Devotion service](https://github.com/rohithmaka/bible-app/blob/main/src/services/dailyDevotionService.ts): `src/services/dailyDevotionService.ts`
- [Devotion content](https://github.com/rohithmaka/bible-app/blob/main/src/data/dailyDevotionsSeed.ts): `src/data/dailyDevotionsSeed.ts`
- [Localized devotions](https://github.com/rohithmaka/bible-app/blob/main/src/data/multilingualDevotions.ts): `src/data/multilingualDevotions.ts`
- [Prayer and circles](https://github.com/rohithmaka/bible-app/blob/main/src/app/(tabs)/prayer.tsx): `src/app/(tabs)/prayer.tsx`
- [Prayer circles](https://github.com/rohithmaka/bible-app/blob/main/src/app/prayer-circles.tsx): `src/app/prayer-circles.tsx`
- [Reminders](https://github.com/rohithmaka/bible-app/blob/main/src/app/reminders.tsx): `src/app/reminders.tsx`

### State and services

- [Bible state](https://github.com/rohithmaka/bible-app/blob/main/src/store/useBibleStore.ts): `src/store/useBibleStore.ts`
- [Devotion state](https://github.com/rohithmaka/bible-app/blob/main/src/store/useDevotionStore.ts): `src/store/useDevotionStore.ts`
- [Spiritual state](https://github.com/rohithmaka/bible-app/blob/main/src/store/useSpiritualStore.ts): `src/store/useSpiritualStore.ts`
- [Reminder state](https://github.com/rohithmaka/bible-app/blob/main/src/store/useReminderStore.ts): `src/store/useReminderStore.ts`
- [Reminder notifications](https://github.com/rohithmaka/bible-app/blob/main/src/services/reminderNotificationService.ts): `src/services/reminderNotificationService.ts`
- [Authentication](https://github.com/rohithmaka/bible-app/blob/main/src/services/authService.ts): `src/services/authService.ts`
- [Supabase client](https://github.com/rohithmaka/bible-app/blob/main/src/services/supabaseConfig.ts): `src/services/supabaseConfig.ts`
- [Local storage](https://github.com/rohithmaka/bible-app/blob/main/src/storage/storage.ts): `src/storage/storage.ts`
- [Cloud sync](https://github.com/rohithmaka/bible-app/blob/main/src/services/supabaseSyncService.ts): `src/services/supabaseSyncService.ts`
- [Devotion sync](https://github.com/rohithmaka/bible-app/blob/main/src/services/cloudDevotionalSyncService.ts): `src/services/cloudDevotionalSyncService.ts`
- [Usage analytics](https://github.com/rohithmaka/bible-app/blob/main/src/services/analyticsService.ts): `src/services/analyticsService.ts`

### Other components

- **App user**

## Connections

- App user → App routing: opens
- App routing → Bible reader: routes to
- App routing → Onboarding: routes to
- App routing → Login: routes to
- Bible reader → Bible state: reads and updates (evidence: `src/app/(tabs)/bible.tsx`)
- Bible reader → Bible engine: uses (evidence: `src/app/(tabs)/bible.tsx`)
- Bible reader → Multi-Bible service: uses (evidence: `src/app/(tabs)/bible.tsx`)
- Bible reader → Translation catalog: uses (evidence: `src/app/(tabs)/bible.tsx`)
- Bible reader → Spiritual state: reads and updates (evidence: `src/app/(tabs)/bible.tsx`)
- Bible search → Bible state: reads and updates (evidence: `src/app/bible-search.tsx`)
- Bible search → Bible engine: searches with (evidence: `src/app/bible-search.tsx`)
- Bible search → Translation catalog: uses (evidence: `src/app/bible-search.tsx`)
- Bible engine → Bible text data: reads (evidence: `src/engine/bibleEngine.ts`)
- Bible engine → Translation catalog: looks up (evidence: `src/engine/bibleEngine.ts`)
- Multi-Bible service → Bible text data: uses (evidence: `src/engine/multiBibleService.ts`)
- Multi-Bible service → Translation catalog: uses (evidence: `src/engine/multiBibleService.ts`)
- Reading planner → Plan engine: uses (evidence: `src/app/one-year-planner.tsx`)
- Reading planner → Bible state: reads and updates (evidence: `src/app/one-year-planner.tsx`)
- Reading planner → Spiritual state: reads and updates
- Daily devotion → Devotion state: uses
- Devotion state → Devotion service: loads from (evidence: `src/store/useDevotionStore.ts`)
- Devotion state → Devotion content: uses (evidence: `src/store/useDevotionStore.ts`)
- Devotion service → Devotion content: reads (evidence: `src/services/dailyDevotionService.ts`)
- Devotion content → Localized devotions: provides seed data (evidence: `src/data/dailyDevotionsSeed.ts`)
- Spiritual state → Localized devotions: gets daily scripture (evidence: `src/store/useSpiritualStore.ts`)
- Localized devotions → Translation catalog: looks up (evidence: `src/data/multilingualDevotions.ts`)
- Localized devotions → Bible engine: gets localized names (evidence: `src/data/multilingualDevotions.ts`)
- Prayer and circles → Spiritual state: reads and updates (evidence: `src/app/(tabs)/prayer.tsx`)
- Prayer and circles → Cloud sync: uses (evidence: `src/app/(tabs)/prayer.tsx`)
- Prayer and circles → Cloud sync: uses (evidence: `src/app/(tabs)/prayer.tsx`)
- Prayer and circles → Bible state: reads and updates (evidence: `src/app/(tabs)/prayer.tsx`)
- Prayer circles → Spiritual state: uses
- Reminders → Reminder state: reads and updates (evidence: `src/app/reminders.tsx`)
- Reminder state → Reminder notifications: schedules and cancels (evidence: `src/store/useReminderStore.ts`)
- Login → Authentication: uses
- Onboarding → Authentication: uses (evidence: `src/app/onboarding-flow.tsx`)
- Onboarding → Supabase client: uses (evidence: `src/app/onboarding-flow.tsx`)
- Authentication → Supabase client: authenticates with (evidence: `src/services/authService.ts`)
- Authentication → Local storage: reads and writes (evidence: `src/services/authService.ts`)
- Supabase client → Local storage: persists sessions (evidence: `src/services/supabaseConfig.ts`)
- Bible state → Local storage: persists (evidence: `src/store/useBibleStore.ts`)
- Bible state → Devotion sync: syncs planner progress (evidence: `src/store/useBibleStore.ts`)
- Reminder state → Local storage: persists (evidence: `src/store/useReminderStore.ts`)
- Spiritual state → Local storage: persists (evidence: `src/store/useSpiritualStore.ts`)
- Devotion state → Local storage: persists (evidence: `src/store/useDevotionStore.ts`)
- Cloud sync → Supabase client: uses (evidence: `src/services/supabaseSyncService.ts`)
- Devotion sync → Supabase client: uses (evidence: `src/services/cloudDevotionalSyncService.ts`)
- Devotion state → Usage analytics: uses (evidence: `src/store/useDevotionStore.ts`)
