Schwitzz
45f5c505c9
Story whiteboard built on React Flow v11: free-form canvas of typed nodes (character, world, chapter, note, image, group) with draggable leads-to/contrasts/causes edges, cross-link selectors (chapter/entity), linked-node badges, and an "Add beats to board" import from the plot. Plot beats feature set: - Status/locking (draft/revised/locked) with a progress bar - Beat templates (three-act, save-the-cat, seven-point, custom) - Timeline route with search/chapter/character filters - Entity cross-links (entityIds) on beats and board nodes - getBoard added to the StorageAdapter contract (local + server) and REST endpoints; loadBoard now restores persisted board state Storage & server: - PlotBeat type (status, entityIds) across core types, Dexie schema, and server mapping/routes/migration (002_plot_beats.sql) - SQLite-safe column names (beat_order, entity_ids) - Server seed data for plot beats UI: accent Button variant, Badge variants, plot/timeline/whiteboard stylesheets. Tests: templates module, plot-beat store round-trip, board getBoard. typecheck, lint, test, and build all green.
PubScript
A self-hostable, multi-user writing studio for novelists — one codebase that runs as a web app and as a native desktop app, with a local-first AI co-writing engine built in.
See PLAN.md for the full vision, architecture, and data model. The CHUNK#n.md files are the executable work orders.
Quickstart
pnpm i && pnpm dev # run the app shell at http://localhost:5173
pnpm test # run every workspace's unit tests
pnpm typecheck # strict TypeScript across the monorepo
pnpm build # build web + server
Docker (self-host)
docker compose -f docker/compose.yaml up --build
# → http://localhost:8080 (health: curl localhost:8080/api/health)
One container serves the web app, runs the Fastify API, and stores SQLite on a volume.
Repository layout
| Path | What it is |
|---|---|
PLAN.md |
Single source of truth for what and why |
CHUNK#n.md |
Executable, step-by-step work orders |
apps/web/ |
React 19 + Vite app (runs in browser AND in Tauri) |
packages/core/ |
Domain types, ULIDs, time, token budget, StorageAdapter contract |
packages/ui/ |
Design tokens, theme engine (Ink / Parchment / Nocturne / Terminal), component kit |
server/ |
Fastify + SQLite: auth, multi-tenant, WS, admin, AI proxy |
docker/ |
Dockerfile + compose (one container serves app + API + data) |
docs/ |
ADRs, data model reference, AI role prompts, parity matrix |
Status
CHUNK #1 — Scaffold & Foundations is complete: monorepo, strict TypeScript, the app shell, the theming system, the packages/core contracts, a Fastify server skeleton, and a green CI pipeline.
Next: CHUNK #2 — Data Model, Storage & Auth.