# ahmedism-npc/counter_and_praying_schedule architecture

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

## Overview

Jadwal Sholat is a Flutter worship companion whose primary workflow is opening the app, reaching the prayer dashboard, and viewing prayer times and countdowns alongside location and date information. Separate branches provide tasbih counting, calendar and agenda management, Qibla direction, preferences and sign-in, and a dynamic doa list. The README documents these capabilities, but the Dart implementation was not sampled, so feature relationships below reflect documented behavior rather than inspected calls. The sampled Windows files show the native Flutter host and plugin registration.

Main entry points: [`lib/screens/main_navigation_screen.dart`](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/screens/main_navigation_screen.dart) (Main navigation), [`lib/features/calendar/screens/calendar_screen.dart`](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/calendar/screens/calendar_screen.dart) (Calendar and agendas), [`lib/features/prayer_times/providers/prayer_provider.dart`](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/prayer_times/providers/prayer_provider.dart) (Prayer state), [`windows/runner/flutter_window.cpp`](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/windows/runner/flutter_window.cpp) (Flutter window host)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_splash["Splash screen<br/>[splash_screen.dart]"]
  node_navigation["Main navigation"]
  node_counter["Tasbih counter"]
  node_counter_state["Counter state"]
  node_settings["User preferences"]
  node_settings_state["Preference state"]
  node_doa["Doa and dzikir list<br/>[doa_page.dart]"]
end

subgraph group_prayer["Prayer tools"]
  node_home["Prayer dashboard<br/>[home_screen.dart]"]
  node_prayer_screen["Prayer times<br/>[prayer_screen.dart]"]
  node_prayer_provider["Prayer state"]
  node_location["Location service"]
  node_prayer_service["Prayer calculation"]
  node_compass["Qibla compass<br/>[qibla_screen.dart]"]
end

subgraph group_calendar["Calendar and account"]
  node_calendar_screen["Calendar and agendas"]
  node_calendar_state["Agenda state"]
  node_agenda_form["Agenda form"]
  node_auth["Google sign-in<br/>[auth_provider.dart]"]
  node_google_calendar["Google Calendar service"]
end

subgraph group_platform["Platform host"]
  node_win_main["Windows entry<br/>[main.cpp]"]
  node_flutter_host["Flutter window host<br/>[flutter_window.cpp]"]
  node_win_window["Win32 window<br/>[win32_window.cpp]"]
  node_plugin_registry["Plugin registration"]
end

node_user(("User"))
node_google_calendar_external(("Google Calendar"))

node_user -->|"opens app"| node_splash
node_splash -->|"continues to"| node_navigation
node_user -->|"selects feature"| node_navigation
node_navigation -->|"shows dashboard"| node_home
node_home -->|"presents times"| node_prayer_screen
node_prayer_screen -.->|"uses state"| node_prayer_provider
node_prayer_provider -.->|"updates location"| node_location
node_prayer_provider -.->|"gets prayer times"| node_prayer_service
node_navigation -->|"opens tasbih"| node_counter
node_counter -.->|"updates count"| node_counter_state
node_navigation -->|"opens calendar"| node_calendar_screen
node_calendar_screen -->|"manages agendas"| node_calendar_state
node_calendar_screen -->|"opens form"| node_agenda_form
node_calendar_screen -->|"imports events"| node_google_calendar
node_auth -.->|"enables sync"| node_google_calendar
node_google_calendar -->|"syncs calendar"| node_google_calendar_external
node_navigation -->|"opens Qibla"| node_compass
node_navigation -->|"opens settings"| node_settings
node_settings -.->|"changes preferences"| node_settings_state
node_navigation -->|"opens doa list"| node_doa
node_win_main -->|"creates host"| node_flutter_host
node_flutter_host -->|"extends window"| node_win_window
node_flutter_host -->|"registers plugins"| node_plugin_registry

click node_splash "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/splash/screens/splash_screen.dart"
click node_navigation "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/screens/main_navigation_screen.dart"
click node_home "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/screens/home_screen.dart"
click node_prayer_screen "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/prayer_times/screens/prayer_screen.dart"
click node_prayer_provider "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/prayer_times/providers/prayer_provider.dart"
click node_location "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/prayer_times/services/location_service.dart"
click node_prayer_service "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/prayer_times/services/prayer_service.dart"
click node_counter "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/counter/screens/counter_screen.dart"
click node_counter_state "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/counter/providers/counter_provider.dart"
click node_calendar_screen "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/calendar/screens/calendar_screen.dart"
click node_calendar_state "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/calendar/providers/calendar_provider.dart"
click node_agenda_form "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/calendar/widgets/add_agenda_bottom_sheet.dart"
click node_auth "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/auth/providers/auth_provider.dart"
click node_google_calendar "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/auth/services/google_calendar_service.dart"
click node_compass "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/compass/screens/qibla_screen.dart"
click node_settings "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/settings/screens/settings_screen.dart"
click node_settings_state "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/settings/providers/settings_provider.dart"
click node_doa "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/pages/doa_page.dart"
click node_win_main "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/windows/runner/main.cpp"
click node_flutter_host "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/windows/runner/flutter_window.cpp"
click node_win_window "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/windows/runner/win32_window.cpp"
click node_plugin_registry "https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/windows/flutter/generated_plugin_registrant.cc"

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_splash,node_navigation,node_counter,node_counter_state,node_settings,node_settings_state,node_doa,node_user toneBlue
class node_home,node_prayer_screen,node_prayer_provider,node_location,node_prayer_service,node_compass toneAmber
class node_calendar_screen,node_calendar_state,node_agenda_form,node_auth,node_google_calendar toneMint
class node_win_main,node_flutter_host,node_win_window,node_plugin_registry toneRose
class node_google_calendar_external toneIndigo
```

## Components

### App experience

- [Splash screen](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/splash/screens/splash_screen.dart): `lib/features/splash/screens/splash_screen.dart`
- [Main navigation](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/screens/main_navigation_screen.dart): `lib/screens/main_navigation_screen.dart`
- [Tasbih counter](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/counter/screens/counter_screen.dart): `lib/features/counter/screens/counter_screen.dart`
- [Counter state](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/counter/providers/counter_provider.dart): `lib/features/counter/providers/counter_provider.dart`
- [User preferences](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/settings/screens/settings_screen.dart): `lib/features/settings/screens/settings_screen.dart`
- [Preference state](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/settings/providers/settings_provider.dart): `lib/features/settings/providers/settings_provider.dart`
- [Doa and dzikir list](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/pages/doa_page.dart): `lib/pages/doa_page.dart`

### Prayer tools

- [Prayer dashboard](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/screens/home_screen.dart): `lib/screens/home_screen.dart`
- [Prayer times](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/prayer_times/screens/prayer_screen.dart): `lib/features/prayer_times/screens/prayer_screen.dart`
- [Prayer state](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/prayer_times/providers/prayer_provider.dart): `lib/features/prayer_times/providers/prayer_provider.dart`
- [Location service](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/prayer_times/services/location_service.dart): `lib/features/prayer_times/services/location_service.dart`
- [Prayer calculation](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/prayer_times/services/prayer_service.dart): `lib/features/prayer_times/services/prayer_service.dart`
- [Qibla compass](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/compass/screens/qibla_screen.dart): `lib/features/compass/screens/qibla_screen.dart`

### Calendar and account

- [Calendar and agendas](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/calendar/screens/calendar_screen.dart): `lib/features/calendar/screens/calendar_screen.dart`
- [Agenda state](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/calendar/providers/calendar_provider.dart): `lib/features/calendar/providers/calendar_provider.dart`
- [Agenda form](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/calendar/widgets/add_agenda_bottom_sheet.dart): `lib/features/calendar/widgets/add_agenda_bottom_sheet.dart`
- [Google sign-in](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/auth/providers/auth_provider.dart): `lib/features/auth/providers/auth_provider.dart`
- [Google Calendar service](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/lib/features/auth/services/google_calendar_service.dart): `lib/features/auth/services/google_calendar_service.dart`

### Platform host

- [Windows entry](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/windows/runner/main.cpp): `windows/runner/main.cpp`
- [Flutter window host](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/windows/runner/flutter_window.cpp): `windows/runner/flutter_window.cpp`
- [Win32 window](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/windows/runner/win32_window.cpp): `windows/runner/win32_window.cpp`
- [Plugin registration](https://github.com/ahmedism-npc/counter_and_praying_schedule/blob/main/windows/flutter/generated_plugin_registrant.cc): `windows/flutter/generated_plugin_registrant.cc`

### Other components

- **User**
- **Google Calendar**

## Connections

- User → Splash screen: opens app (evidence: `README.md`)
- Splash screen → Main navigation: continues to (evidence: `README.md`)
- User → Main navigation: selects feature (evidence: `README.md`)
- Main navigation → Prayer dashboard: shows dashboard (evidence: `README.md`)
- Prayer dashboard → Prayer times: presents times (evidence: `README.md`)
- Prayer times → Prayer state: uses state
- Prayer state → Location service: updates location
- Prayer state → Prayer calculation: gets prayer times
- Main navigation → Tasbih counter: opens tasbih (evidence: `README.md`)
- Tasbih counter → Counter state: updates count
- Main navigation → Calendar and agendas: opens calendar (evidence: `README.md`)
- Calendar and agendas → Agenda state: manages agendas (evidence: `README.md`)
- Calendar and agendas → Agenda form: opens form (evidence: `README.md`)
- Calendar and agendas → Google Calendar service: imports events (evidence: `README.md`)
- Google sign-in → Google Calendar service: enables sync
- Google Calendar service → Google Calendar: syncs calendar (evidence: `README.md`)
- Main navigation → Qibla compass: opens Qibla (evidence: `README.md`)
- Main navigation → User preferences: opens settings (evidence: `README.md`)
- User preferences → Preference state: changes preferences
- Main navigation → Doa and dzikir list: opens doa list (evidence: `README.md`)
- Windows entry → Flutter window host: creates host (evidence: `windows/runner/main.cpp`)
- Flutter window host → Win32 window: extends window (evidence: `windows/runner/flutter_window.cpp`)
- Flutter window host → Plugin registration: registers plugins (evidence: `windows/runner/flutter_window.cpp`)
