Core concepts

The handful of ideas the rest of the docs build on — projects, chat, the preview, checkpoints and credits.

Vorx has a small vocabulary. Learn these six and everything else follows.

Projects

A project is one app. It holds your chat history, the generated code, its database, its settings and its live preview. Projects are independent of each other — one app's data and secrets are never visible to another.

Each project has its own Settings, organised as General, Analytics, Forms, Cloud, GitHub and SEO, with Dev Console under Advanced. Most of the pages in these docs point at one of those sections.

Chat

Chat is how you build. Every message is an instruction — to create something, change it, or fix it. Vorx reads your intent, makes the change, and updates the preview. There's no separate "edit mode"; the conversation is the editor.

Chat has three modes: Build, which makes the change, Cost preview, which estimates it first, and Plan, which proposes an approach first. See Build and Plan modes.

The preview

The preview is your app running live, not a screenshot. Click buttons, submit forms, follow links. It updates as Vorx makes changes, so you're always looking at the real thing.

Alongside the preview you can switch to visual mode to point at elements, comments to leave notes, and theme to adjust the look.

Checkpoints

Every change Vorx applies is saved as a checkpoint. If an edit goes the wrong way, you can roll back to any earlier point — so you can experiment freely without losing work. Rolling back doesn't call the model, so it doesn't cost credits.

Credits

Builds and edits spend credits from your workspace's balance. Credits are whole numbers: a charged run costs at least one, and more as the real model spend for that run grows. Each reply in chat shows what it used. See Plans and credit usage.

Environments

Your working copy and your published app are separate. You build against the preview; your users see the published app at your-app.vorx.live or your own domain. See Environments.

Next steps

Your first app — the full walkthrough
How Vorx works — the pipeline behind a build
Glossary — every term in one place