# yellowbench/click-prototype architecture

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

- Interactive diagram: https://gitdiagram.com/yellowbench/click-prototype
- Repository: https://github.com/yellowbench/click-prototype

## Overview

Click is a local demo website and ESP32 bracelet prototype: two boards exchange taps while disconnected, then a browser pairs over Bluetooth and syncs confirmed encounters into a local timeline. The map follows browser controls through GATT transport, HTTP preview routes, durable SQLite storage, and timeline projection/rendering, alongside the two firmware boards. Firmware and Frontend.html internals were not sampled, so their documented roles are shown without speculative internal call edges.

Main entry points: [`scripts/preview-bracelet.mjs`](https://github.com/yellowbench/click-prototype/blob/main/scripts/preview-bracelet.mjs) (Local preview server), [`scripts/bracelet-controls.mjs`](https://github.com/yellowbench/click-prototype/blob/main/scripts/bracelet-controls.mjs) (Browser controls), [`Frontend.html`](https://github.com/yellowbench/click-prototype/blob/main/Frontend.html) (Click interface), [`firmware/Click_Board_A/Click_Board_A.ino`](https://github.com/yellowbench/click-prototype/blob/main/firmware/Click_Board_A/Click_Board_A.ino) (Board A)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Local website"]
  node_frontend["Click interface<br/>[Frontend.html]"]
  node_preview["Local preview server"]
  node_timeline["Timeline rendering"]
end

subgraph group_sync["Bracelet sync"]
  node_controls["Browser controls"]
  node_client["Bracelet client"]
  node_gatt["GATT transport"]
end

subgraph group_storage["Local encounter data"]
  node_sqlite[("Encounter database")]
  node_projection["Encounter projection"]
end

subgraph group_firmware["ESP32 firmware"]
  node_boarda["Board A<br/>[Click_Board_A.ino]"]
  node_boardb["Board B<br/>[Click_Board_B.ino]"]
end

node_person(("Demo user"))
node_bluetooth["Browser Bluetooth"]

node_person -->|"uses"| node_frontend
node_frontend -->|"loads locally"| node_preview
node_preview -->|"serves"| node_frontend
node_preview -->|"renders with"| node_timeline
node_preview -->|"opens and reads"| node_sqlite
node_preview -->|"projects timeline"| node_projection
node_frontend -->|"initializes controls"| node_controls
node_controls -->|"connects and syncs"| node_client
node_client -->|"sends commands"| node_gatt
node_gatt -->|"uses GATT"| node_bluetooth
node_controls -->|"posts batches"| node_preview
node_preview -->|"saves batches"| node_sqlite
node_projection -->|"projects stored records"| node_sqlite
node_boarda -.->|"exchanges taps"| node_boardb
node_person -.->|"taps while disconnected"| node_boarda
node_person -.->|"taps while disconnected"| node_boardb
node_boarda -.->|"syncs when paired"| node_bluetooth
node_boardb -.->|"syncs when paired"| node_bluetooth
node_controls -->|"refreshes timeline"| node_projection

click node_frontend "https://github.com/yellowbench/click-prototype/blob/main/Frontend.html"
click node_preview "https://github.com/yellowbench/click-prototype/blob/main/scripts/preview-bracelet.mjs"
click node_timeline "https://github.com/yellowbench/click-prototype/blob/main/scripts/bracelet-timeline.mjs"
click node_controls "https://github.com/yellowbench/click-prototype/blob/main/scripts/bracelet-controls.mjs"
click node_client "https://github.com/yellowbench/click-prototype/blob/main/scripts/bracelet-client.mjs"
click node_gatt "https://github.com/yellowbench/click-prototype/blob/main/scripts/bracelet-client.mjs"
click node_boarda "https://github.com/yellowbench/click-prototype/blob/main/firmware/Click_Board_A/Click_Board_A.ino"
click node_boardb "https://github.com/yellowbench/click-prototype/blob/main/firmware/Click_Board_B/Click_Board_B.ino"
click node_sqlite "https://github.com/yellowbench/click-prototype/blob/main/scripts/encounter-store.mjs"
click node_projection "https://github.com/yellowbench/click-prototype/blob/main/scripts/encounter-store.mjs"

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_frontend,node_preview,node_timeline,node_person,node_bluetooth toneBlue
class node_controls,node_client,node_gatt toneAmber
class node_sqlite,node_projection toneMint
class node_boarda,node_boardb toneRose
```

## Components

### Local website

- [Click interface](https://github.com/yellowbench/click-prototype/blob/main/Frontend.html): `Frontend.html`
- [Local preview server](https://github.com/yellowbench/click-prototype/blob/main/scripts/preview-bracelet.mjs): `scripts/preview-bracelet.mjs`
- [Timeline rendering](https://github.com/yellowbench/click-prototype/blob/main/scripts/bracelet-timeline.mjs): `scripts/bracelet-timeline.mjs`

### Bracelet sync

- [Browser controls](https://github.com/yellowbench/click-prototype/blob/main/scripts/bracelet-controls.mjs): `scripts/bracelet-controls.mjs`
- [Bracelet client](https://github.com/yellowbench/click-prototype/blob/main/scripts/bracelet-client.mjs): `scripts/bracelet-client.mjs`
- [GATT transport](https://github.com/yellowbench/click-prototype/blob/main/scripts/bracelet-client.mjs): `scripts/bracelet-client.mjs`

### Local encounter data

- [Encounter database](https://github.com/yellowbench/click-prototype/blob/main/scripts/encounter-store.mjs): `scripts/encounter-store.mjs`
- [Encounter projection](https://github.com/yellowbench/click-prototype/blob/main/scripts/encounter-store.mjs): `scripts/encounter-store.mjs`

### ESP32 firmware

- [Board A](https://github.com/yellowbench/click-prototype/blob/main/firmware/Click_Board_A/Click_Board_A.ino): `firmware/Click_Board_A/Click_Board_A.ino`
- [Board B](https://github.com/yellowbench/click-prototype/blob/main/firmware/Click_Board_B/Click_Board_B.ino): `firmware/Click_Board_B/Click_Board_B.ino`

### Other components

- **Demo user**
- **Browser Bluetooth**

## Connections

- Demo user → Click interface: uses (evidence: `README.md`)
- Click interface → Local preview server: loads locally (evidence: `scripts/preview-bracelet.mjs`)
- Local preview server → Click interface: serves (evidence: `scripts/preview-bracelet.mjs`)
- Local preview server → Timeline rendering: renders with (evidence: `scripts/preview-bracelet.mjs`)
- Local preview server → Encounter database: opens and reads (evidence: `scripts/preview-bracelet.mjs`)
- Local preview server → Encounter projection: projects timeline (evidence: `scripts/preview-bracelet.mjs`)
- Click interface → Browser controls: initializes controls
- Browser controls → Bracelet client: connects and syncs (evidence: `scripts/bracelet-controls.mjs`)
- Bracelet client → GATT transport: sends commands (evidence: `scripts/bracelet-client.mjs`)
- GATT transport → Browser Bluetooth: uses GATT (evidence: `scripts/bracelet-client.mjs`)
- Browser controls → Local preview server: posts batches (evidence: `scripts/bracelet-controls.mjs`)
- Local preview server → Encounter database: saves batches (evidence: `scripts/preview-bracelet.mjs`)
- Encounter projection → Encounter database: projects stored records (evidence: `scripts/preview-bracelet.mjs`)
- Board A → Board B: exchanges taps (evidence: `README.md`)
- Demo user → Board A: taps while disconnected (evidence: `README.md`)
- Demo user → Board B: taps while disconnected (evidence: `README.md`)
- Board A → Browser Bluetooth: syncs when paired (evidence: `README.md`)
- Board B → Browser Bluetooth: syncs when paired (evidence: `README.md`)
- Browser controls → Encounter projection: refreshes timeline (evidence: `scripts/bracelet-controls.mjs`)
