NilsBriggen ba5ae37111 V2 P5-backend + P7 + P8: conflict-safe sync, revocable invites, feats, multiclass, tests
P5 backend (the deferred items):
- conflict-aware cloud sync via optimistic concurrency: the server versions each
  backup blob (file mtime) and rejects a push whose base version is stale (409),
  so a second device can't silently overwrite a newer cloud copy. The client
  tracks its last-synced version; the SyncStatusIndicator surfaces a "Sync
  conflict" with one-click resolution (Use cloud / Keep this device), and the
  Settings push offers the same choice.
- revocable invites: owner can rotate a campaign's invite code (kills the old
  one) and remove a member (drops them + deletes their published characters).
  (Skipped editor/player roles — no enforcement target in the current model.)
- image storage: deliberately deferred (live images already stream de-duped on a
  separate channel; a backup blob-store is infra with no correctness gain).

P7 — subclass/feat/multiclass depth:
- feats are now first-class tracked records (name + effect text) in a Feats &
  Features sheet section, not buried in notes. Dexie v15 migration.
- 5e multiclass spell-slot calculator: a pure multiclassSlots() (full ×1, half
  ÷2, third ÷3 → full-caster table) + a sheet control to fill the slot table for
  multiclass casters. (Honest scope: tracking + slots, not per-subclass feature
  automation.)

P8 — test hardening: v2-surfaces e2e (feats, multiclass calc, signals bell,
World nav) + server tests (blob versioning, invite rotation, member removal) +
multiclass unit tests.

Gate green: 283 unit + 35 e2e + 2 realtime. App + server build clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-09 10:34:29 +02:00
2026-06-07 23:47:39 +02:00
2026-06-07 23:47:39 +02:00
2026-06-07 23:47:39 +02:00
2026-06-07 23:47:39 +02:00
2026-06-07 23:47:39 +02:00

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.

S
Description
No description provided
Readme 17 MiB
Languages
TypeScript 98.7%
CSS 0.6%
Python 0.5%
JavaScript 0.1%