Troubleshooting

The first turn is taking forever

Cold-start time on a fresh sandbox is 2–3 minutes. The agent has to install dependencies before it can publish a snapshot. The Generating status will stick around the whole time.

If it's been more than 5 minutes, the bootstrap may have failed. Look for an error message in the chat or send a follow-up — the next turn will retry the install if needed.

The preview is empty after a successful turn

The agent's chat says it published a snapshot, but the iframe shows the empty state. Try:

1. Click Refresh in the preview toolbar
2. If that doesn't help, the snapshot's signed URL may have failed to mint. Refresh the whole page (Cmd+R)
3. If it's still empty, ask the agent to publish again — "Just publish what you have, no changes needed"

The preview shows a 403 or 404

The signed URL probably expired or didn't persist correctly. Refresh the page; the editor will mint a fresh signed URL on mount. If the issue persists across refreshes, the snapshot itself may be missing — send a follow-up message asking the agent to re-publish.

Tool calls show errors in the chat

You'll see a tool-call pill with an error icon if a tool failed. Common causes:

• write_sandbox_file errored — sandbox is unreachable. Wait a moment and re-prompt.
• publish_design_snapshot errored — storage credentials may be misconfigured (admin issue). Contact your workspace admin.
• get_brand_context errored — usually transient. The agent will continue without brand context if this happens; results will look more generic.

"Generating" never finishes

The agent's loop got stuck. Wait 5 minutes — turns can be long. If it's truly stuck, refresh the page and send a new message. The previous turn's partial state is discarded.

I changed the output type but the design didn't change

Switching the output type chip just tells the next turn to think differently. It doesn't auto-trigger a regeneration. Send a follow-up like "Convert this page into a 5-slide deck" to actually rebuild for the new type.

I sent a message but the agent didn't respond

A few possibilities:

• The chat got disconnected. Refresh the page; pending messages may need to be re-sent.
• The Mastra service is down. Check with your workspace admin or wait a few minutes.
• Your message was too long. There's a soft limit. Break long messages into shorter ones.

The brand panel is empty / has no controls

In v1.0, the brand panel is a placeholder. Set brand context through the chat (describe colors, fonts, tone) or via Image Studio's Insert into… → Design. The full brand panel ships in a later phase.

I deleted a design by mistake

Deletion is permanent. There's no trash. If you need the design, you'll have to recreate it — but the chat thread, brand context, and snapshots are all gone.

To avoid this, the Delete menu item asks for confirmation before deleting.

My signed URL stopped working when I shared it

Signed URLs are time-bounded. They work for the duration they were issued for and then expire. Use the Open in new tab button to mint a fresh URL when you need to share, or share through the standard share dialog (ships in phase 4) for permanent access.

The iframe is laggy or unresponsive

Heavy animations, large videos, or many simultaneous interactive elements can make the iframe slow. Try:

• Maximize the preview to give it more room to render
• Open in a new tab to escape the iframe sandbox
• Ask the agent to simplify ("Smaller hero video", "Fewer animations on scroll")

I want a previous version of my design back

Pin version and rollback ship in phase 4. In v1.0, the cleanest way back to an earlier state is to describe what you want and let the agent rebuild it ("Go back to the version with the dark hero and the three feature cards"). The agent has the snapshot history in context and can usually re-create earlier looks.