Guides
How vvd works, one topic at a time.
Each guide covers one topic in depth. The tutorial introduces every one of these ideas inline, at the moment it's needed — come here when you want the whole truth about a topic.
The mental modelWorld, era, project, app, tool, block — six nouns, one sentence.Project anatomyEvery file the scaffold writes, and every field in vvd.json.Storing dataThe codec: fields, merge behavior, and why there's no save button.Retrieving and changing datauseDocument — the snapshot, the mutators, and the status you must render.Reading the worldQuery the world's documents, eras, and media from any creation.PresenceWho's here, live — cursors, names, and colors.The hostWhy one tool runs unchanged in the app, a share link, and a published site.External APIs and secretsThe api/ server half, and where an API key actually lives.TestingcreateFakeHost() — prove your creation works without a browser.Ship itsave, share, publish — three stages, and how to undo each one.