# zabrodsk/partydeck architecture

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

- Interactive diagram: https://gitdiagram.com/zabrodsk/partydeck
- Repository: https://github.com/zabrodsk/partydeck

## Overview

Partydeck is a browser-based multiplayer card-night app: players create or join a room, invite others, and play poker or blackjack from private phones, optionally alongside a shared table display. The Node server is the documented live runtime; it owns rooms, rules, profiles, and filtered game views. A separate experimental Worker/D1 adapter restores room state across requests. The graph retains the documented profile, invitation, display, and motion capabilities; the excerpts do not show every route or client request, so unsupported connections are omitted.

Main entry points: [`server/index.js`](https://github.com/zabrodsk/partydeck/blob/main/server/index.js) (HTTP and events), [`server/rooms.js`](https://github.com/zabrodsk/partydeck/blob/main/server/rooms.js) (Room lifecycle), [`public/app.js`](https://github.com/zabrodsk/partydeck/blob/main/public/app.js) (Table UI), [`server/auth.js`](https://github.com/zabrodsk/partydeck/blob/main/server/auth.js) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser experience"]
  node_browser["Table UI<br/>[app.js]"]
  node_betting["Betting controls<br/>[betting.js]"]
  node_cardmotion["Card motion<br/>[motion.js]"]
end

subgraph group_node["Node runtime"]
  node_http["HTTP and events<br/>[index.js]"]
  node_assetdelivery["Asset delivery<br/>[assets.js]"]
  node_invites["QR invitations<br/>[qr.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_profiles[("Profiles and stats<br/>[storage.js]")]
  node_sqlite[("SQLite state<br/>[storage.js]")]
end

subgraph group_games["Game domain"]
  node_rooms["Room lifecycle<br/>[rooms.js]"]
  node_poker["Hold’em rules<br/>[rooms.js]"]
  node_blackjack["Blackjack rules<br/>[blackjack.js]"]
end

subgraph group_worker["Worker adapter"]
  node_workerentry["Worker HTTP adapter<br/>[index.js]"]
  node_workerdb[("D1 persistence<br/>[database.js]")]
  node_workerrooms["Restored room state<br/>[room-state.js]"]
end

node_players(("Players"))
node_workos["WorkOS AuthKit"]
node_d1[("Cloudflare D1")]

node_players -->|"play through"| node_browser
node_browser -->|"uses controls"| node_betting
node_browser -->|"animates cards"| node_cardmotion
node_browser -.->|"HTTP actions"| node_http
node_http -->|"serves assets"| node_assetdelivery
node_http -.->|"generates QR"| node_invites
node_http -->|"routes sign-in"| node_auth
node_auth -.->|"resolves identity"| node_profiles
node_auth -->|"PKCE sign-in"| node_workos
node_http -->|"handles room actions"| node_rooms
node_rooms -->|"runs Hold’em"| node_poker
node_rooms -->|"uses blackjack rules"| node_blackjack
node_rooms -.->|"updates statistics"| node_profiles
node_profiles -->|"reads and writes"| node_sqlite
node_players -.->|"Worker requests"| node_workerentry
node_workerentry -->|"handles API state"| node_workerdb
node_workerdb -->|"hydrates and mutates"| node_workerrooms
node_workerrooms -->|"reuses room rules"| node_rooms
node_workerrooms -->|"restores blackjack"| node_blackjack
node_workerdb -.->|"persists records"| node_d1

click node_browser "https://github.com/zabrodsk/partydeck/blob/main/public/app.js"
click node_betting "https://github.com/zabrodsk/partydeck/blob/main/public/betting.js"
click node_cardmotion "https://github.com/zabrodsk/partydeck/blob/main/public/motion.js"
click node_http "https://github.com/zabrodsk/partydeck/blob/main/server/index.js"
click node_assetdelivery "https://github.com/zabrodsk/partydeck/blob/main/server/assets.js"
click node_invites "https://github.com/zabrodsk/partydeck/blob/main/server/qr.js"
click node_auth "https://github.com/zabrodsk/partydeck/blob/main/server/auth.js"
click node_profiles "https://github.com/zabrodsk/partydeck/blob/main/server/storage.js"
click node_rooms "https://github.com/zabrodsk/partydeck/blob/main/server/rooms.js"
click node_poker "https://github.com/zabrodsk/partydeck/blob/main/server/rooms.js"
click node_blackjack "https://github.com/zabrodsk/partydeck/blob/main/server/blackjack.js"
click node_sqlite "https://github.com/zabrodsk/partydeck/blob/main/server/storage.js"
click node_workerentry "https://github.com/zabrodsk/partydeck/blob/main/worker/index.js"
click node_workerdb "https://github.com/zabrodsk/partydeck/blob/main/worker/database.js"
click node_workerrooms "https://github.com/zabrodsk/partydeck/blob/main/worker/room-state.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_browser,node_betting,node_cardmotion toneBlue
class node_http,node_assetdelivery,node_invites,node_auth,node_profiles,node_sqlite,node_d1 toneAmber
class node_rooms,node_poker,node_blackjack toneMint
class node_workerentry,node_workerdb,node_workerrooms toneRose
class node_players,node_workos toneIndigo
```

## Components

### Browser experience

- [Table UI](https://github.com/zabrodsk/partydeck/blob/main/public/app.js): `public/app.js`
- [Betting controls](https://github.com/zabrodsk/partydeck/blob/main/public/betting.js): `public/betting.js`
- [Card motion](https://github.com/zabrodsk/partydeck/blob/main/public/motion.js): `public/motion.js`

### Node runtime

- [HTTP and events](https://github.com/zabrodsk/partydeck/blob/main/server/index.js): `server/index.js`
- [Asset delivery](https://github.com/zabrodsk/partydeck/blob/main/server/assets.js): `server/assets.js`
- [QR invitations](https://github.com/zabrodsk/partydeck/blob/main/server/qr.js): `server/qr.js`
- [Authentication](https://github.com/zabrodsk/partydeck/blob/main/server/auth.js): `server/auth.js`
- [Profiles and stats](https://github.com/zabrodsk/partydeck/blob/main/server/storage.js): `server/storage.js`
- [SQLite state](https://github.com/zabrodsk/partydeck/blob/main/server/storage.js): `server/storage.js`

### Game domain

- [Room lifecycle](https://github.com/zabrodsk/partydeck/blob/main/server/rooms.js): `server/rooms.js`
- [Hold’em rules](https://github.com/zabrodsk/partydeck/blob/main/server/rooms.js): `server/rooms.js`
- [Blackjack rules](https://github.com/zabrodsk/partydeck/blob/main/server/blackjack.js): `server/blackjack.js`

### Worker adapter

- [Worker HTTP adapter](https://github.com/zabrodsk/partydeck/blob/main/worker/index.js): `worker/index.js`
- [D1 persistence](https://github.com/zabrodsk/partydeck/blob/main/worker/database.js): `worker/database.js`
- [Restored room state](https://github.com/zabrodsk/partydeck/blob/main/worker/room-state.js): `worker/room-state.js`

### Other components

- **Players**
- **WorkOS AuthKit**
- **Cloudflare D1**

## Connections

- Players → Table UI: play through (evidence: `README.md`)
- Table UI → Betting controls: uses controls (evidence: `public/app.js`)
- Table UI → Card motion: animates cards (evidence: `public/app.js`)
- Table UI → HTTP and events: HTTP actions (evidence: `README.md`)
- HTTP and events → Asset delivery: serves assets (evidence: `server/index.js`)
- HTTP and events → QR invitations: generates QR (evidence: `server/index.js`)
- HTTP and events → Authentication: routes sign-in (evidence: `server/index.js`)
- Authentication → Profiles and stats: resolves identity
- Authentication → WorkOS AuthKit: PKCE sign-in (evidence: `server/auth.js`)
- HTTP and events → Room lifecycle: handles room actions (evidence: `server/index.js`)
- Room lifecycle → Hold’em rules: runs Hold’em (evidence: `server/rooms.js`)
- Room lifecycle → Blackjack rules: uses blackjack rules (evidence: `server/rooms.js`)
- Room lifecycle → Profiles and stats: updates statistics
- Profiles and stats → SQLite state: reads and writes (evidence: `server/storage.js`)
- Players → Worker HTTP adapter: Worker requests (evidence: `README.md`)
- Worker HTTP adapter → D1 persistence: handles API state (evidence: `worker/index.js`)
- D1 persistence → Restored room state: hydrates and mutates (evidence: `worker/database.js`)
- Restored room state → Room lifecycle: reuses room rules (evidence: `worker/room-state.js`)
- Restored room state → Blackjack rules: restores blackjack (evidence: `worker/room-state.js`)
- D1 persistence → Cloudflare D1: persists records (evidence: `README.md`)
