> ## Documentation Index
> Fetch the complete documentation index at: https://docs.convonexai.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# The preview

> Your live app in the workspace — what the stages mean, and how sleep and wake work.

The Preview tab shows your actual running app, hot-reloading as the agent
writes files — no refresh, no deploy step.

## Before the app is live

Until there's something to show, the preview is an honest status screen, not a
spinner. What it says maps to where the build really is:

| You see                                                                            | What's happening                                                                                                                                                                                         |
| ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "Getting started" / "Writing it down" / "Designing"                                | The agent is reading your idea, specifying and planning. **No workspace is running and nothing is billed** during this — that's by design.                                                               |
| **Your turn** — "The plan is ready to review — nothing is built until you say go." | The review pause. See [Reviewing the plan](/building/plan-review).                                                                                                                                       |
| "Booting your workspace — about 10 seconds."                                       | Your workspace is starting after approval.                                                                                                                                                               |
| "Setting up sign-in"                                                               | A capability (like authentication) is provisioning; the build parked rather than shipping around it, and continues on its own. No countdown is shown because the real time is unknowable — no fake ETAs. |
| "Installing" / "Compiling"                                                         | Dependencies pulling, then the first build — the slowest one; later reloads are instant.                                                                                                                 |
| "Welcome back — bringing your workspace back online — your work is preserved."     | Waking from sleep.                                                                                                                                                                                       |
| **Something went wrong**                                                           | A platform fault on our side — operators have been notified. See [Troubleshooting](/help/troubleshooting).                                                                                               |

Once live, the status pill uses the customer vocabulary — **Building → Testing
→ Polishing → Ready** — and stays **Ready** while you browse your app even as
the agent keeps editing (changes hot-reload in).

## The toolbar

| Control                                       | What it does                                                                                                                  |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Phone / Desktop**                           | Frame the preview at 390px or desktop width — the two viewports the design pipeline actually produces and verifies.           |
| **Start dev server / Restart (clears cache)** | One state-aware button. Restart relaunches your app's dev server inside the workspace — the fix for a stuck or stale preview. |
| **Reload**                                    | Refreshes just the iframe — a page refresh, no server restart.                                                                |
| **Open in new tab**                           | Your preview at its own URL, full-window.                                                                                     |

The preview URL (shown above the frame) is your development app. It's distinct
from the permanent production URL you get from
[publishing](/shipping/publish).

## Sleep & wake

To avoid burning resources while you're away, a project's workspace goes to
sleep after roughly **30 minutes** of inactivity. Nothing is lost — your files,
database, and conversation are all preserved. When you come back, waking takes
around 10 seconds ("Welcome back"). Your **published** production app is
unaffected by sleep — it stays up.

If the preview seems blank or stuck after waking, the toolbar's **Restart**
button is the first thing to try — see [Troubleshooting](/help/troubleshooting).