A project is one operation, scoped end-to-end. It owns its database tables, its plan, its scenes, its checkpoints, its preview link, and its export. Nothing leaks across projects.
What a project contains
| Object | Mutable from | Stored where |
|---|---|---|
| Blueprint | Plan mode + AI chat | project_blueprints (Supabase) |
| Schema | Build mode + AI chat | project_schemas + dynamic tables |
| Tasks | Plan and Build modes | project_tasks |
| Saved scenes | Build mode | project_saved_scenes |
| Checkpoints | Auto + AI moves | project_schema_checkpoints |
| Preview | Deploy mode | project_previews |
| Activity | Derived | multiple tables, read-only |
Blueprint
The Blueprint is the human-readable plan: app goal, audience, planned pages, planned tables (logical, not yet physical), roles, integrations, and tasks. It is editable in Plan mode and consumed by Build from plan.
Schema and tables
The schema is the live data structure. Tables you see in Data mode are the realized version of the Blueprint's planned tables. Each row lives in a tenant-scoped database namespace and is gated by row-level security so only the project owner can touch it.
Tasks
Tasks come from two sources: the AI generates a backlog when it plans, and you can add manual tasks from Build mode. Status moves through draft, active, ready, done. Tasks are local guidance; nothing in the AI loop is gated on completing a task.
Saved scenes
A scene is a frozen UI snapshot — a specific table view, form, or chart configuration. You save scenes when you want to reopen the same view later without re-prompting. The chat rail shows your saved scenes; clicking one rehydrates it.
Checkpoints
Every schema-changing AI move snapshots the project schema before it runs. If something looks wrong, restore the previous checkpoint with one click. See the Checkpoints article for what restore does and does not change.
Preview link
Deploy mode mints a token-based public URL that loads the project read-only. Visitors never see chat, owner controls, or any other project. Rotate the token to revoke instantly.
Export package
The export pulls the entire project into a JSON file (plus a human-readable Markdown summary) covering blueprint, schema, tasks, scenes, checkpoints metadata, readiness score, integrations metadata, and preview status. It never contains raw API keys or the preview share token itself.