deck: Instructions file for Claude Code

deck

Storylines are markdown files; this app renders them as 16:9 slides you can scroll through and draw on while recording a voiceover. README.md is the user-facing doc — this file is the working reference for the internals.

Run it

npm run dev            # vite, http://localhost:5290 — the app-development loop
npm start              # build, then the CLI, serving the built app
npm run mcp            # build, then the MCP server on stdio
npm run typecheck      # client, node, and the tests
npm test               # the unit tests, no build needed

Shape

Three front ends over one core. The rule that makes this work: nothing product-shaped lives in vite.config.ts, and nothing transport-shaped lives in server/store.ts.

server/paths.ts    package root, dist and the export script, found not counted
server/config.ts   where the decks are — argument, then env, then env file, then ./decks
server/slides.ts   the slide grammar. imports no `node:`, so it bundles to the browser too
server/store.ts    every filesystem operation. no HTTP, no MCP
server/api.ts      the HTTP surface over a store; resolves true when it handled a request
server/serve.ts    the standalone server: built app + api + live reload, no Vite
vite.config.ts     the dev adapter — middleware around the same handler
bin/deck.ts        the CLI
mcp/               the MCP server and the syntax crib it hands to agents
src/               the React app
scripts/export.ts  PNG export, driving `serve` through Playwright
scripts/bundle.ts  the Claude Desktop extension (.mcpb), staged and packed
mcpb/icon.html     the extension icon's source; the png is rendered from it

The extension

npm run bundle writes build/deck-<version>.mcpb — a zip of manifest.json, lib/, dist/, an icon, and a production-only node_modules installed into the staging directory. It has to be self-contained: the host runs node lib/bin/deck.js mcp directly, with no install step and no guarantee the user has ever run npm.