# nyanpoketto-kujira/masjid-you architecture

> Architecture diagram of the GitHub repository nyanpoketto-kujira/masjid-you, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nyanpoketto-kujira/masjid-you
- Repository: https://github.com/nyanpoketto-kujira/masjid-you

## Overview

Masjid You is an offline-first mosque display and companion remote. An operator edits mosque settings and display content in the mobile app, then sends changes to the TV over local WebSocket or Bluetooth Classic; the TV renders the kiosk view. The TV also serves as the local WebSocket endpoint and hosts Bluetooth, while shared models define sync data and offline prayer-schedule calculations. The graph follows README-documented capabilities; most Dart implementation files were not sampled, so internal app-to-app wiring is limited to documented relationships.

Main entry points: [`apps/mobile_remote/lib/screens`](https://github.com/nyanpoketto-kujira/masjid-you/tree/main/apps/mobile_remote/lib/screens) (Remote Editors), [`apps/mobile_remote/lib/screens/connection/connection_gateway_screen.dart`](https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/mobile_remote/lib/screens/connection/connection_gateway_screen.dart) (Connection Gateway), [`apps/mobile_remote/lib/services/ws_client.dart`](https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/mobile_remote/lib/services/ws_client.dart) (WebSocket Client), [`packages/shared_models/lib/src/sync_packet.dart`](https://github.com/nyanpoketto-kujira/masjid-you/blob/main/packages/shared_models/lib/src/sync_packet.dart) (Sync Models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_remote["Mobile Remote"]
  node_remote_ui["Remote Editors"]
  node_remote_conn["Connection Gateway"]
  node_remote_ws["WebSocket Client<br/>[ws_client.dart]"]
  node_remote_bt["Bluetooth Client"]
  node_remote_backup["Backup Service"]
end

subgraph group_display["TV Display"]
  node_tv_view["Kiosk Display"]
  node_tv_state["Display State<br/>[tv_store.dart]"]
  node_prayer_state["Prayer State"]
  node_tv_ws["WebSocket Server"]
  node_tv_bt["Bluetooth Host"]
end

subgraph group_connectivity["Local Sync"]
  node_ws_network{{"Local WebSocket"}}
  node_bt_plugin["Bluetooth RFCOMM"]
end

subgraph group_shared["Shared Domain"]
  node_sync_models["Sync Models<br/>[sync_packet.dart]"]
  node_prayer_models["Prayer Schedule Models"]
  node_content_models["Display Content Models"]
end

node_operator(("Mosque Operator"))

node_operator -->|"edits content"| node_remote_ui
node_remote_ui -->|"connects via"| node_remote_conn
node_remote_conn -->|"selects WebSocket"| node_remote_ws
node_remote_conn -->|"selects Bluetooth"| node_remote_bt
node_remote_ws -->|"sends updates"| node_ws_network
node_ws_network -->|"delivers updates"| node_tv_ws
node_remote_bt -->|"uses RFCOMM"| node_bt_plugin
node_tv_bt -->|"hosts RFCOMM"| node_bt_plugin
node_remote_ws -->|"syncs packets"| node_sync_models
node_tv_ws -->|"syncs packets"| node_sync_models
node_remote_ui -.->|"backs up data"| node_remote_backup
node_tv_state -.->|"provides display state"| node_tv_view
node_prayer_state -.->|"drives prayer display"| node_tv_view
node_prayer_models -->|"supports scheduling"| node_prayer_state
node_content_models -.->|"defines sync data"| node_sync_models

click node_remote_ui "https://github.com/nyanpoketto-kujira/masjid-you/tree/main/apps/mobile_remote/lib/screens"
click node_remote_conn "https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/mobile_remote/lib/screens/connection/connection_gateway_screen.dart"
click node_remote_ws "https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/mobile_remote/lib/services/ws_client.dart"
click node_remote_bt "https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/mobile_remote/lib/services/bluetooth_client_service.dart"
click node_remote_backup "https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/mobile_remote/lib/services/backup_service.dart"
click node_tv_view "https://github.com/nyanpoketto-kujira/masjid-you/tree/main/apps/tv_display/lib/widgets"
click node_tv_state "https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/tv_display/lib/state/tv_store.dart"
click node_prayer_state "https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/tv_display/lib/state/prayer_state_machine.dart"
click node_tv_ws "https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/tv_display/lib/server/local_ws_server.dart"
click node_tv_bt "https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/tv_display/lib/server/bluetooth_host_service.dart"
click node_bt_plugin "https://github.com/nyanpoketto-kujira/masjid-you/blob/main/packages/bluetooth_sync/lib/bluetooth_sync.dart"
click node_sync_models "https://github.com/nyanpoketto-kujira/masjid-you/blob/main/packages/shared_models/lib/src/sync_packet.dart"
click node_prayer_models "https://github.com/nyanpoketto-kujira/masjid-you/blob/main/packages/shared_models/lib/src/prayer_schedule.dart"
click node_content_models "https://github.com/nyanpoketto-kujira/masjid-you/tree/main/packages/shared_models/lib/src"

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_remote_ui,node_remote_conn,node_remote_ws,node_remote_bt,node_remote_backup toneBlue
class node_tv_view,node_tv_state,node_prayer_state,node_tv_ws,node_tv_bt toneAmber
class node_ws_network,node_bt_plugin toneMint
class node_sync_models,node_prayer_models,node_content_models toneRose
class node_operator toneIndigo
```

## Components

### Mobile Remote

- [Remote Editors](https://github.com/nyanpoketto-kujira/masjid-you/tree/main/apps/mobile_remote/lib/screens): `apps/mobile_remote/lib/screens`
- [Connection Gateway](https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/mobile_remote/lib/screens/connection/connection_gateway_screen.dart): `apps/mobile_remote/lib/screens/connection/connection_gateway_screen.dart`
- [WebSocket Client](https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/mobile_remote/lib/services/ws_client.dart): `apps/mobile_remote/lib/services/ws_client.dart`
- [Bluetooth Client](https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/mobile_remote/lib/services/bluetooth_client_service.dart): `apps/mobile_remote/lib/services/bluetooth_client_service.dart`
- [Backup Service](https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/mobile_remote/lib/services/backup_service.dart): `apps/mobile_remote/lib/services/backup_service.dart`

### TV Display

- [Kiosk Display](https://github.com/nyanpoketto-kujira/masjid-you/tree/main/apps/tv_display/lib/widgets): `apps/tv_display/lib/widgets`
- [Display State](https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/tv_display/lib/state/tv_store.dart): `apps/tv_display/lib/state/tv_store.dart`
- [Prayer State](https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/tv_display/lib/state/prayer_state_machine.dart): `apps/tv_display/lib/state/prayer_state_machine.dart`
- [WebSocket Server](https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/tv_display/lib/server/local_ws_server.dart): `apps/tv_display/lib/server/local_ws_server.dart`
- [Bluetooth Host](https://github.com/nyanpoketto-kujira/masjid-you/blob/main/apps/tv_display/lib/server/bluetooth_host_service.dart): `apps/tv_display/lib/server/bluetooth_host_service.dart`

### Local Sync

- **Local WebSocket**
- [Bluetooth RFCOMM](https://github.com/nyanpoketto-kujira/masjid-you/blob/main/packages/bluetooth_sync/lib/bluetooth_sync.dart): `packages/bluetooth_sync/lib/bluetooth_sync.dart`

### Shared Domain

- [Sync Models](https://github.com/nyanpoketto-kujira/masjid-you/blob/main/packages/shared_models/lib/src/sync_packet.dart): `packages/shared_models/lib/src/sync_packet.dart`
- [Prayer Schedule Models](https://github.com/nyanpoketto-kujira/masjid-you/blob/main/packages/shared_models/lib/src/prayer_schedule.dart): `packages/shared_models/lib/src/prayer_schedule.dart`
- [Display Content Models](https://github.com/nyanpoketto-kujira/masjid-you/tree/main/packages/shared_models/lib/src): `packages/shared_models/lib/src`

### Other components

- **Mosque Operator**

## Connections

- Mosque Operator → Remote Editors: edits content (evidence: `README.md`)
- Remote Editors → Connection Gateway: connects via (evidence: `README.md`)
- Connection Gateway → WebSocket Client: selects WebSocket (evidence: `README.md`)
- Connection Gateway → Bluetooth Client: selects Bluetooth (evidence: `README.md`)
- WebSocket Client → Local WebSocket: sends updates (evidence: `README.md`)
- Local WebSocket → WebSocket Server: delivers updates (evidence: `README.md`)
- Bluetooth Client → Bluetooth RFCOMM: uses RFCOMM (evidence: `README.md`)
- Bluetooth Host → Bluetooth RFCOMM: hosts RFCOMM (evidence: `README.md`)
- WebSocket Client → Sync Models: syncs packets (evidence: `README.md`)
- WebSocket Server → Sync Models: syncs packets (evidence: `README.md`)
- Remote Editors → Backup Service: backs up data
- Display State → Kiosk Display: provides display state
- Prayer State → Kiosk Display: drives prayer display
- Prayer Schedule Models → Prayer State: supports scheduling (evidence: `README.md`)
- Display Content Models → Sync Models: defines sync data
