A static-site branching fiction engine. Stories are YAML files played in the browser — no server, no build step, no framework.
Inspired by Fighting Fantasy, Fabled Lands, Lone Wolf.
npx serve .
Or use VS Code Live Server (right-click index.html → Open with Live Server). file:// won't work — the engine uses fetch() to load YAML.
- Stories are folders under
stories/{id}/ - Each story has a
story.yaml(metadata, starting stats) and scene files inscenes/ - The engine loads scenes on demand, tracks state in LocalStorage, renders choices filtered by flags/stats
- Per-story
theme.cssoverrides the default palette and fonts
See docs/ for full documentation:
docs/foundation.md— design philosophydocs/engine.md— state, navigation, effects, audiodocs/frontend.md— layout, CSS variables, theming
Run /new-story in Claude Code to start the guided story creation pipeline.
Once the story is written, generate audio:
python scripts/tts_server.py # start TTS server (port 5500)
python scripts/generate_audio.py # generate audio for all stories