# vjs5/rowmance architecture

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

- Interactive diagram: https://gitdiagram.com/vjs5/rowmance
- Repository: https://github.com/vjs5/rowmance

## Overview

Rowmance is a networked, local co-op paddle game. The main loop is to start or join a session, assign players to opposite sides of a shared boat, paddle through checkpoints, and reach the finish. The README documents the major input, multiplayer, progression, save, pause, and end-sequence systems. No source excerpts were provided, and the documented gameplay directories are absent from the supplied tree, so gameplay paths are null; edges reflect README statements only.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_session["Session Setup"]
  node_menu["Menu and Settings"]
  node_network["Host and Client"]
  node_lobby["Lobby"]
end

subgraph group_gameplay["Boat Gameplay"]
  node_inputmode["Input Mode"]
  node_mobile["Mobile Touch"]
  node_paddleinput["Paddle Input"]
  node_boat["Boat Movement"]
  node_pause["Network Pause"]
end

subgraph group_progress["Progress and Saves"]
  node_checkpoint["Checkpoints"]
  node_progresscalc["Path Progress"]
  node_savemanager["Save Manager"]
  node_savedata["Save Data"]
  node_savecrypto["Save Signing"]
  node_storage[("Persistent Storage")]
end

subgraph group_presentation["UI and Feedback"]
  node_endtrigger["End Trigger"]
  node_finalui["Final Sequence"]
  node_credits["Credits"]
  node_audio["Audio Feedback"]
end

node_players(("Players"))

node_players -->|"choose session"| node_menu
node_menu -->|"host or join"| node_network
node_network -->|"start session"| node_lobby
node_menu -->|"load save"| node_savemanager
node_menu -->|"select input mode"| node_inputmode
node_mobile -->|"send paddle taps"| node_paddleinput
node_inputmode -->|"route input"| node_paddleinput
node_paddleinput -->|"send paddle actions"| node_boat
node_boat -->|"play feedback"| node_audio
node_players -->|"control assigned side"| node_boat
node_players -->|"pause or resume"| node_pause
node_boat -->|"reach checkpoints"| node_checkpoint
node_checkpoint -->|"track path progress"| node_progresscalc
node_checkpoint -->|"update save state"| node_savemanager
node_progresscalc -->|"provide progress"| node_savemanager
node_savemanager -->|"cache save state"| node_savedata
node_savemanager -->|"sign payload"| node_savecrypto
node_savemanager -->|"read write delete"| node_storage
node_savecrypto -->|"protect payload"| node_storage
node_boat -->|"reach finish"| node_endtrigger
node_endtrigger -->|"show tally"| node_finalui
node_finalui -->|"continue sequence"| node_credits

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_menu,node_network,node_lobby toneBlue
class node_inputmode,node_mobile,node_paddleinput,node_boat,node_pause toneAmber
class node_checkpoint,node_progresscalc,node_savemanager,node_savedata,node_savecrypto,node_storage toneMint
class node_endtrigger,node_finalui,node_credits,node_audio toneRose
class node_players toneIndigo
```

## Components

### Session Setup

- **Menu and Settings**
- **Host and Client**
- **Lobby**

### Boat Gameplay

- **Input Mode**
- **Mobile Touch**
- **Paddle Input**
- **Boat Movement**
- **Network Pause**

### Progress and Saves

- **Checkpoints**
- **Path Progress**
- **Save Manager**
- **Save Data**
- **Save Signing**
- **Persistent Storage**

### UI and Feedback

- **End Trigger**
- **Final Sequence**
- **Credits**
- **Audio Feedback**

### Other components

- **Players**

## Connections

- Players → Menu and Settings: choose session (evidence: `README.md`)
- Menu and Settings → Host and Client: host or join (evidence: `README.md`)
- Host and Client → Lobby: start session (evidence: `README.md`)
- Menu and Settings → Save Manager: load save (evidence: `README.md`)
- Menu and Settings → Input Mode: select input mode (evidence: `README.md`)
- Mobile Touch → Paddle Input: send paddle taps (evidence: `README.md`)
- Input Mode → Paddle Input: route input (evidence: `README.md`)
- Paddle Input → Boat Movement: send paddle actions (evidence: `README.md`)
- Boat Movement → Audio Feedback: play feedback (evidence: `README.md`)
- Players → Boat Movement: control assigned side (evidence: `README.md`)
- Players → Network Pause: pause or resume (evidence: `README.md`)
- Boat Movement → Checkpoints: reach checkpoints (evidence: `README.md`)
- Checkpoints → Path Progress: track path progress (evidence: `README.md`)
- Checkpoints → Save Manager: update save state (evidence: `README.md`)
- Path Progress → Save Manager: provide progress (evidence: `README.md`)
- Save Manager → Save Data: cache save state (evidence: `README.md`)
- Save Manager → Save Signing: sign payload (evidence: `README.md`)
- Save Manager → Persistent Storage: read write delete (evidence: `README.md`)
- Save Signing → Persistent Storage: protect payload (evidence: `README.md`)
- Boat Movement → End Trigger: reach finish (evidence: `README.md`)
- End Trigger → Final Sequence: show tally (evidence: `README.md`)
- Final Sequence → Credits: continue sequence (evidence: `README.md`)
