# dmz34705/dmzscuba-app architecture

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

- Interactive diagram: https://gitdiagram.com/dmz34705/dmzscuba-app
- Repository: https://github.com/dmz34705/dmzscuba-app

## Overview

DMZ Scuba is a local-first Expo/React Native companion connecting dive records, computer downloads, equipment, site research, and trip planning. A diver enters through the app navigator and uses the logbook, Gear Locker, Ocean Atlas, Planner, training labs, and identification/sharing tools; saved dive data also informs Atlas pins and personal guidance. The graph preserves README capabilities whose implementation was not sampled, but omits speculative links to them. Relationships are cited only where shown in excerpts, the source index, or README.

Main entry points: [`src/application/AppNavigator.js`](https://github.com/dmz34705/dmzscuba-app/blob/main/src/application/AppNavigator.js) (Navigation), [`src/screens/DiveLogScreen.js`](https://github.com/dmz34705/dmzscuba-app/blob/main/src/screens/DiveLogScreen.js) (Logbook UI), [`src/screens/OceanAtlasScreen.js`](https://github.com/dmz34705/dmzscuba-app/blob/main/src/screens/OceanAtlasScreen.js) (Ocean Atlas), [`src/features/diveLog/useDiveLog.js`](https://github.com/dmz34705/dmzscuba-app/blob/main/src/features/diveLog/useDiveLog.js) (Logbook workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_app["App startup<br/>[App.js]"]
  node_navigation["Navigation<br/>[AppNavigator.js]"]
  node_account["Account sync<br/>[accountDataSync.js]"]
end

subgraph group_records["Dive records"]
  node_logscreen["Logbook UI<br/>[DiveLogScreen.js]"]
  node_loghook["Logbook workflow<br/>[useDiveLog.js]"]
  node_logstore[("Dive storage<br/>[storage.js]")]
  node_photo["Photo matching<br/>[photoMatching.js]"]
end

subgraph group_gear["Gear and downloads"]
  node_computer["Computer downloads<br/>[downloadService.js]"]
  node_bridge["Native computer bridge<br/>[index.js]"]
  node_gearui["Gear Locker"]
  node_gearstate[("Gear state<br/>[storage.js]")]
end

subgraph group_discover["Atlas and planning"]
  node_atlas["Ocean Atlas"]
  node_sitejoin["Site linking<br/>[storage.js]"]
  node_planner["Dive Planner<br/>[PlannerScreen.js]"]
  node_plannerflow["Planner state<br/>[usePlanner.js]"]
end

subgraph group_tools["Training and sharing"]
  node_labs["Training labs"]
  node_lens["Dive Lens<br/>[DiveLensScreen.js]"]
  node_share["Photo and dive sharing"]
end

node_diver(("Diver"))
node_cloud["DMZ account service"]

node_diver -->|"opens"| node_app
node_app -->|"starts"| node_navigation
node_navigation -->|"routes to"| node_logscreen
node_navigation -->|"routes to"| node_atlas
node_navigation -->|"routes to"| node_planner
node_navigation -.->|"routes to"| node_gearui
node_navigation -->|"routes to"| node_labs
node_navigation -->|"routes to"| node_lens
node_logscreen -->|"uses"| node_loghook
node_loghook -->|"reads and writes"| node_logstore
node_logscreen -->|"uses matching"| node_photo
node_computer -->|"saves logs"| node_logstore
node_computer -.->|"downloads from"| node_bridge
node_gearui -.->|"manages"| node_gearstate
node_loghook -->|"offers site links"| node_sitejoin
node_sitejoin -->|"loads plans"| node_plannerflow
node_planner -.->|"uses"| node_plannerflow
node_logscreen -->|"coordinates inform pins"| node_atlas
node_atlas -->|"informs gear proposals"| node_gearui
node_planner -->|"uses researched location"| node_atlas
node_lens -->|"matches log photos"| node_logstore
node_diver -->|"creates shared media"| node_share
node_account -->|"syncs records"| node_cloud

click node_app "https://github.com/dmz34705/dmzscuba-app/blob/main/App.js"
click node_navigation "https://github.com/dmz34705/dmzscuba-app/blob/main/src/application/AppNavigator.js"
click node_logscreen "https://github.com/dmz34705/dmzscuba-app/blob/main/src/screens/DiveLogScreen.js"
click node_loghook "https://github.com/dmz34705/dmzscuba-app/blob/main/src/features/diveLog/useDiveLog.js"
click node_logstore "https://github.com/dmz34705/dmzscuba-app/blob/main/src/lib/diveLog/storage.js"
click node_photo "https://github.com/dmz34705/dmzscuba-app/blob/main/src/lib/diveLog/photoMatching.js"
click node_computer "https://github.com/dmz34705/dmzscuba-app/blob/main/src/features/diveComputerDownload/downloadService.js"
click node_bridge "https://github.com/dmz34705/dmzscuba-app/blob/main/modules/dive-computer-bridge/index.js"
click node_gearui "https://github.com/dmz34705/dmzscuba-app/blob/main/src/screens/GearChecklistScreen.js"
click node_gearstate "https://github.com/dmz34705/dmzscuba-app/blob/main/src/features/gearChecklist/storage.js"
click node_atlas "https://github.com/dmz34705/dmzscuba-app/blob/main/src/screens/OceanAtlasScreen.js"
click node_sitejoin "https://github.com/dmz34705/dmzscuba-app/blob/main/src/features/siteDives/storage.js"
click node_planner "https://github.com/dmz34705/dmzscuba-app/blob/main/src/screens/PlannerScreen.js"
click node_plannerflow "https://github.com/dmz34705/dmzscuba-app/blob/main/src/features/planner/usePlanner.js"
click node_labs "https://github.com/dmz34705/dmzscuba-app/tree/main/src/features"
click node_lens "https://github.com/dmz34705/dmzscuba-app/blob/main/src/screens/DiveLensScreen.js"
click node_share "https://github.com/dmz34705/dmzscuba-app/tree/main/src/features/divePhotoShare"
click node_account "https://github.com/dmz34705/dmzscuba-app/blob/main/src/lib/accountDataSync.js"

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_navigation,node_account toneBlue
class node_logscreen,node_loghook,node_logstore,node_photo toneAmber
class node_computer,node_bridge,node_gearui,node_gearstate toneMint
class node_atlas,node_sitejoin,node_planner,node_plannerflow toneRose
class node_labs,node_lens,node_share,node_diver,node_cloud toneIndigo
```

## Components

### App experience

- [App startup](https://github.com/dmz34705/dmzscuba-app/blob/main/App.js): `App.js`
- [Navigation](https://github.com/dmz34705/dmzscuba-app/blob/main/src/application/AppNavigator.js): `src/application/AppNavigator.js`
- [Account sync](https://github.com/dmz34705/dmzscuba-app/blob/main/src/lib/accountDataSync.js): `src/lib/accountDataSync.js`

### Dive records

- [Logbook UI](https://github.com/dmz34705/dmzscuba-app/blob/main/src/screens/DiveLogScreen.js): `src/screens/DiveLogScreen.js`
- [Logbook workflow](https://github.com/dmz34705/dmzscuba-app/blob/main/src/features/diveLog/useDiveLog.js): `src/features/diveLog/useDiveLog.js`
- [Dive storage](https://github.com/dmz34705/dmzscuba-app/blob/main/src/lib/diveLog/storage.js): `src/lib/diveLog/storage.js`
- [Photo matching](https://github.com/dmz34705/dmzscuba-app/blob/main/src/lib/diveLog/photoMatching.js): `src/lib/diveLog/photoMatching.js`

### Gear and downloads

- [Computer downloads](https://github.com/dmz34705/dmzscuba-app/blob/main/src/features/diveComputerDownload/downloadService.js): `src/features/diveComputerDownload/downloadService.js`
- [Native computer bridge](https://github.com/dmz34705/dmzscuba-app/blob/main/modules/dive-computer-bridge/index.js): `modules/dive-computer-bridge/index.js`
- [Gear Locker](https://github.com/dmz34705/dmzscuba-app/blob/main/src/screens/GearChecklistScreen.js): `src/screens/GearChecklistScreen.js`
- [Gear state](https://github.com/dmz34705/dmzscuba-app/blob/main/src/features/gearChecklist/storage.js): `src/features/gearChecklist/storage.js`

### Atlas and planning

- [Ocean Atlas](https://github.com/dmz34705/dmzscuba-app/blob/main/src/screens/OceanAtlasScreen.js): `src/screens/OceanAtlasScreen.js`
- [Site linking](https://github.com/dmz34705/dmzscuba-app/blob/main/src/features/siteDives/storage.js): `src/features/siteDives/storage.js`
- [Dive Planner](https://github.com/dmz34705/dmzscuba-app/blob/main/src/screens/PlannerScreen.js): `src/screens/PlannerScreen.js`
- [Planner state](https://github.com/dmz34705/dmzscuba-app/blob/main/src/features/planner/usePlanner.js): `src/features/planner/usePlanner.js`

### Training and sharing

- [Training labs](https://github.com/dmz34705/dmzscuba-app/tree/main/src/features): `src/features`
- [Dive Lens](https://github.com/dmz34705/dmzscuba-app/blob/main/src/screens/DiveLensScreen.js): `src/screens/DiveLensScreen.js`
- [Photo and dive sharing](https://github.com/dmz34705/dmzscuba-app/tree/main/src/features/divePhotoShare): `src/features/divePhotoShare`

### Other components

- **Diver**
- **DMZ account service**

## Connections

- Diver → App startup: opens (evidence: `README.md`)
- App startup → Navigation: starts (evidence: `App.js`)
- Navigation → Logbook UI: routes to (evidence: `src/application/AppNavigator.js`)
- Navigation → Ocean Atlas: routes to (evidence: `src/application/AppNavigator.js`)
- Navigation → Dive Planner: routes to (evidence: `src/application/AppNavigator.js`)
- Navigation → Gear Locker: routes to (evidence: `src/application/AppNavigator.js`)
- Navigation → Training labs: routes to (evidence: `src/application/AppNavigator.js`)
- Navigation → Dive Lens: routes to (evidence: `src/application/AppNavigator.js`)
- Logbook UI → Logbook workflow: uses (evidence: `src/screens/DiveLogScreen.js`)
- Logbook workflow → Dive storage: reads and writes (evidence: `src/features/diveLog/useDiveLog.js`)
- Logbook UI → Photo matching: uses matching (evidence: `src/screens/DiveLogScreen.js`)
- Computer downloads → Dive storage: saves logs (evidence: `src/features/diveComputerDownload/downloadService.js`)
- Computer downloads → Native computer bridge: downloads from
- Gear Locker → Gear state: manages
- Logbook workflow → Site linking: offers site links (evidence: `src/features/diveLog/useDiveLog.js`)
- Site linking → Planner state: loads plans (evidence: `src/features/siteDives/storage.js`)
- Dive Planner → Planner state: uses
- Logbook UI → Ocean Atlas: coordinates inform pins (evidence: `README.md`)
- Ocean Atlas → Gear Locker: informs gear proposals (evidence: `README.md`)
- Dive Planner → Ocean Atlas: uses researched location (evidence: `README.md`)
- Dive Lens → Dive storage: matches log photos (evidence: `src/screens/DiveLensScreen.js`)
- Diver → Photo and dive sharing: creates shared media (evidence: `README.md`)
- Account sync → DMZ account service: syncs records (evidence: `src/lib/accountDataSync.js`)
