🌍 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 JSON
• Escape — 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.