Skip to content

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

50 Commits

Folders and files

Repository files navigation

World Builder

A notes-first writing tool for authors and game devs. Capture ideas anywhere (especially mobile), brainstorm with an AI that knows your world, and gradually crystallise everything into structured entities, chapters, and timeline events — without forcing you to pre-design the whole thing.

Status: planning phase. The product, architecture and data model are designed and documented. Implementation hasn't started yet.

Vision

Most writing tools (Scrivener, World Anvil, etc.) impose a structure from day one. World Builder embraces creative chaos as the natural starting state and provides tools to progressively shape it into a coherent world:

Idea → Note → AI brainstorm → Promotion → Structure (entities, chapters, events)

Notes are the clay. Entities, chapters and events are the fired pottery. You spend 80% of your time shaping clay; you fire it when you're ready.

Stack

  • Frontend: React 18 + TypeScript + Vite, deployed as an installable PWA (works on desktop and mobile)
  • Backend: Supabase (Postgres + Auth + Edge Functions + Realtime)
  • LLM: OpenAI (v1) via Edge Functions, with provider abstraction for Anthropic / OpenRouter / etc.
  • Hosting: Vercel
  • No native shell, no Rust — 100% TypeScript end-to-end.

See docs/architecture.md for the rationale.

Documentation

The docs/ folder is the source of truth. Start here:

Roadmap

Vertical slicing — each slice is a shippable, end-to-end-usable app:

Slice What works
0 Login, create/list empty worlds, deployed PWA
1 ⭐ Quick capture (mobile-first) + AI chat on notes — the core value proposition
2 Entities (without versioning) + tag entities on a note for chat context
3 Auto-extraction of entities + promotion note → entity
4 Books / Parts / Chapters hierarchy + promotion note → chapter
5 Timeline + events + drag-to-reorder ranks
6 Append-only entity versioning + "state at rank R" resolution
7 Upscale + Proposals (structured entity diffs from chapter text)
8 Reader view + summaries S/M/L + runs history + search + published flag

Details in docs/NEXT-STEPS.md.

Getting started

(Setup instructions will be added once Slice 0 lands.)

License

TBD.

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages