BuildBetter Docs

The Editor

The editor (/prototype/:id) is where the redesign happens. Canvas on the left, chat with the agent on the right.

Canvas (Left)

The canvas renders the captured webpage (or blank canvas) in a same-origin iframe. The iframe is locked to the prototype — link clicks and form submissions are intercepted so you can't navigate away by accident.

Toolbar

The toolbar at the top of the canvas has four control groups.

Select Element

The Select element button (mouse cursor icon) toggles a click-to-select mode.

When active:

Click the button again or click anywhere outside an element to exit select mode.

Viewport

Four buttons control the canvas width:

Button Width
Desktop (monitor icon) 1280px
Tablet (tablet icon) 768px
Mobile (smartphone icon) 375px
Fit (eye icon) Full pane width

Your choice persists in localStorage — the editor remembers it across reloads.

The panel-icon button collapses the right chat sidebar to give the canvas full width. Useful when you want a closer look. State persists across reloads.

Iframe Behavior

Chat Sidebar (Right)

The chat sidebar holds the conversation with the agent.

Conversation

The chat history shows user messages and agent responses in order.

Agent responses combine three things:

Empty state: "Describe a change. Try: 'make the hero headline red and bigger' or 'remove the footer'."

While the agent is working, you'll see a "Working..." spinner. Errors surface in a banner with a retry option.

Composer

The text input at the bottom of the sidebar accepts your prompts.

Quick Prompts

The Quick prompts dropdown (wand icon) below the composer holds a menu of pre-written prompts. Clicking one inserts the full text into the composer for review — it doesn't auto-submit. See AI Editing for the full list.

Iterations Strip

When more than one version exists, the Iterations strip appears at the bottom of the canvas.

Auto-Save

Every completed turn (user message + agent response) saves a new version. There's no manual save button. If a save is in flight and a new turn completes, the latest snapshot queues and saves once the in-flight request finishes.

Tip: If you're about to try a risky change, use Fork first. You get a clean prototype to experiment in, and the original keeps its current version as the latest.