Volter World

World cookbook

Runnable recipes, each an outcome against twins with real SDKs, fake keys and local state. Consult the model for shared state semantics and the CLI reference for current commands. A recipe that needs a real service or a checkout of another repository says so on its page.

Start with a complete application

Copy a starter with volter example <name> --dir <empty-folder>, install its exact dependencies, review its detected vendors, then run it inside a World. The source stays with your app; no private application checkout or platform account is required.

ExampleWhat you can do
Customer onboardingCreate a customer, store SQL application state, send a welcome email, inspect a bounce or refusal, and resume a partial signup; browser form included
Workplace handoffGive an agent ordinary company context, link a GitHub issue to a Linear ticket, report it to Slack, and retry a refused notification
Baseline and integrationStart two workers from shared data and deliver selected changesets to a separate integration World

Demo a workflow reuses the onboarding app rather than asking you to invent another demo. These pages describe their source workflows; their exact dependencies do not establish an executed walk. Execution claims require their own retained evidence.

Start with a small example

These recipes use exact published packages and require no private source checkout or platform account. Use one in an empty directory. Each page names its prerequisites, assertions and limits.

RecipeOutcomePrerequisites
Browser signup and signed webhooksCreate an account, persist its session, inspect vendor data, verify a callback and sign outNode 22.6+, npm; Chromium for the automated suite
Hosted Checkout and the customer portalDecline and retry a payment, start a trial, manage cancellation and replace a card through vendor pagesNode 22.6+, npm; Stripe 3.0.3+ with hosted-page support and World browser creation
Repeatable data and behaviorCreate a record, assert a one-time fault, retry a scripted answer, reset and repeatNode 22.6+, npm
Isolated CI workersRun two independent jobs and stop each World after success or failureNode 22.6+, npm; package registry during preparation
Transactional emailSend with Resend's SDK, inspect a local sign-in code and resume the same messageNode 22.6+, npm
AI messages and streamingConsume a labeled local response through Anthropic's unchanged SDK and streamNode 22.6+, npm
Run a tool and stream its resultConsume a scripted OpenAI tool call, create a GitHub issue through its SDK and stream the confirmationNode 22.6+, npm
Users and sessionsCreate a user, verify a session token, revoke and resume its stored stateNode and npm
Redis data and quotasStore a customer, consume a fixed-window quota, resume it and advance to the next windowNode and npm; pinned Upstash SDKs
Object storageUpload and read a file with the real S3 SDK, then resume the same stored objectNode 22.6+, npm; Cloudflare R2 scope
Managed app databaseObtain a local Supabase database connection, store a record and read it after resumeNode 22.6+, npm; PostgreSQL-wire scope

Tutorials teach a task step by step; cookbook recipes assemble reusable workflows. Getting started is the first local lesson. Manual adoption, recovery and coverage explain how to adapt a recipe to your app.

Larger application case studies live in the source repository and name their own checkout prerequisites. This site serves the complete starter examples above.

View Markdown source

On this page