🌍 World Builder
A browser-based worldbuilding workspace for organizing characters, events, places, factions, items, lore, and world rules. Link related entries, choose a genre theme, and keep your project in a portable JSON file.
Open World Builder
Features
- Organize story details into structured sections, including characters, events, locations, factions, items, lore, and world rules.
- Link entries by ID and navigate between related world elements.
- Choose from 28 genre themes and switch between left-to-right and right-to-left text direction.
- Search, filter, duplicate, and edit entries; undo deletions.
- Auto-save in browser storage, or import and export a world as JSON.
- Import JSON from Google Drive share links or raw GitHub URLs.
- Use UTF-8 text for multilingual projects.
Get started
Use the hosted app
Open the live app. Your edits are stored in that browser's local storage. Export your world to JSON regularly to keep a backup or move it to another browser.
Run a local copy
Download or clone this repository, then open index.html in a browser. The app uses plain HTML, CSS, and JavaScript; no build step or package installation is required.
Import and export
- Export JSON downloads the current world as a file.
- Copy JSON copies the data to the clipboard; Preview opens the JSON in a new tab.
- Import accepts a JSON file or a supported Google Drive share link or raw GitHub URL. For a hosted file to be fetched, it must be accessible to your browser.
World data includes collections for characters, events, locations, factions, items, lore, and rules, plus project metadata such as title, author, language, and theme.
Keyboard shortcuts
Ctrl/Cmd + S — save or download the world as JSONEscape — close an open modal
Project files
| File | Responsibility |
|---|
index.html | Page structure and module script loading |
app.js | Startup and application orchestration |
data.js, schemas.js | Data model and component definitions |
components.js, ui.js | Entry forms, rendering, and interface behavior |
storage.js | Browser persistence and JSON import/export |
themes.js, styles.css | Themes and visual styling |
tests/ | Import and functionality regression tests |
Development
There is no build step. The test files use Node's built-in test runner:
node --test tests/*.test.cjs
Privacy and backups
World data is saved in local storage in the browser where you use the app. Imported files are fetched from the link you provide. Export JSON to back up your work; clearing browser storage can remove the local copy.
License
MIT. See LICENSE.
