NilsBriggen
a8cb7d65f4
- Shared Zod wire protocol (src/lib/sync/messages.ts): hosted/joined/snapshot/ mapImage/error; player-safe projections only (enemy HP masked on the GM before broadcast via src/lib/combat/playerProjection.ts). - wsSync adapter (src/lib/sync/wsSync.ts) behind the existing SyncAdapter seam: GM hostSession + debounced snapshot broadcast (useSessionBroadcaster), player joinSession into an ephemeral playerSessionStore, exponential-backoff reconnect with seamless room resume (GM secret). localSync remains the offline default. - buildSnapshot (src/lib/sync/snapshot.ts) reuses the same projection as the local /play view, guaranteeing parity. Player view refactored into shared PlayerBoards; /play?room=CODE = networked read-only mode. - SessionControl in the header: Host (optional password) → shareable room code/link. - Server (server/): Fastify + @fastify/websocket + @fastify/static, in-memory GM-authoritative rooms (crypto room id/secret hashed, optional join password, TTL sweep, players strictly read-only), origin allowlist, per-frame size cap + rate limit, Zod validation. esbuild bundle (server/build.mjs), tsconfig.server.json. - Dockerfile (multi-stage) + deploy/ttrpg.compose.yml (own project on external 'proxy' net, Traefik labels for ttrpg.briggen.dev, non-root, no-new-privileges). CSP connect-src now allows same-origin wss:. Tests: protocol round-trip, room hub (auth/password/resume/TTL/read-only), enemy masking, Fastify+ws integration (host→join→snapshot, player push rejected), and a two-context Playwright realtime spec (separate config) — GM hosts, player device sees live combat with masked enemy HP. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
TTRPG Manager
A local-first campaign manager for D&D 5e and Pathfinder 2e, built for both Game Masters and players. Runs entirely in the browser (installable as a PWA) — your data lives in IndexedDB on your device; no account, no server.
Features (MVP)
- Campaigns — create per-system campaigns; deleting one cascades to all its data.
- Characters — 5e/PF2e sheets with live derived stats: ability modifiers, proficiency, skills, saves, AC, initiative, HP (with damage/heal/temp). Autosaves.
- Combat tracker — initiative order, round/turn tracking, conditions, HP, and add/remove/reorder mid-fight without ever corrupting whose turn it is.
- Dice — full notation (
2d6+3,4d6kh3), advantage/disadvantage, seedable RNG, per-campaign roll history. - Compendium — searchable SRD bestiary, spells, and magic items. Add any monster straight into the open encounter.
Tech
- React 19 + TypeScript (strict) + Vite
- TanStack Router · Zustand · Zod · Dexie (IndexedDB) · Tailwind v4 · Fuse.js
- Vitest (unit) + Playwright (e2e), PWA via vite-plugin-pwa
Architecture
src/
lib/
rules/ # game-system abstraction — 5e & pf2e behind one RulesSystem interface
combat/ # pure, tested turn-order + HP engine
dice/ # notation parser + roller
db/ # Dexie schema + repositories (cascade deletes, validation on write)
schemas/ # Zod entity schemas — every number rejects NaN/Infinity
compendium/ # lazy SRD data loaders (code-split out of the main bundle)
features/ # campaigns, characters, combat, dice, compendium (UI)
components/ui/ # design-system primitives
data/srd/ # SRD JSON (Open5e + MPMB); regenerate with scripts/fetch_data.py
The rules layer means features never branch on if (system === '5e'); they call the
RulesSystem interface, so adding a system is a self-contained module.
Development
bun install
bun run dev # dev server at http://localhost:5173
bun run test # unit tests (vitest)
bun run test:e2e # end-to-end (playwright)
bun run build # typecheck + production build
bun run lint
Roadmap
Notes/journal, maps with fog of war, encounter/loot builders, a shared player view, PF2e compendium data, and an optional sync backend for real-time tables.
History
This is a from-scratch rebuild. The previous implementation (deleted) had ~135
documented bugs and no version control; its bug report is kept at
docs/OLD_BUG_HUNT_REPORT.md as a record of failure modes designed against here
(silent data loss, turn-order corruption, no cascade deletes, NaN inputs, dead
Tauri integration). The SRD data and Python scrapers were preserved.