Preview an app
Preview is the first tab on an app's page. It runs your app inside Studio rather than sending you to it, so you can check a change without losing your place.
Who can use it: the Builder role or higher.
While it loads
The frame shows Starting the preview… with a note that a large app can take a few seconds the first time and is cached afterwards. That wait is the app itself booting and serving its first response, not Studio fetching something.
The rail
Beside the frame, App details collects what the app is, in three groups.
| Group | What it holds |
|---|---|
| SOURCE | Repo, Branch and Entry, the file the app starts from |
| RUNTIME | Type, the framework, Tier, the compute shape, Min pods and Max pods, and Storage |
| OWNERSHIP | Owner and Created |
These are what the app was deployed with. Changing any of them is on the Settings tab, and most of them restart the app.
When the frame shows something else
An app that is not serving gets a labelled placeholder rather than a blank frame, and each one names where to look next.
| State | What it says | Where to go |
|---|---|---|
| Building | Your app is building | The Logs tab, for progress |
| Failed | The last deploy failed, and the reason, which the card names rather than sending you to find | The Deploys tab, for the full log |
| Error | The app entered an error state | Logs, for details |
| Sleeping | The app is sleeping to save cost | Open the address to wake it |
| Unknown | The app is not running | Logs, for details |
A failed card also shows the pod's own diagnosis where there is one: how many times it restarted, the exit code, and the reason, such as a crash loop.
The Sleeping state is worth reading carefully. Auto-sleep is recorded but nothing acts on it yet, so an app that reads sleeping got there some other way.
When the app blocks embedding
If the frame stays empty and the tab says App blocks embedding, your app is sending a header that refuses to be framed. The message names the two that do it, and says plainly that the app itself works fine and you should open it directly to check.
This is your app's own choice, not a platform limit. Most frameworks do not set either header by default, so it usually means something in your code or a proxy in front of it added one. Remove it if you want the preview, or use Open app in new tab and leave it.
Open it properly
Open app and Open app in new tab both go to the app's real address. Use a new tab when you want the app at full width, when you are testing something the frame makes awkward, or when the app refuses to be embedded.
The app is served from a path on the platform's own host, which is what makes embedding possible at all. That also means the frame shares an origin with Studio, so the platform explicitly denies the embedded app the camera, microphone, screen capture and location that a same-origin frame would otherwise inherit. See App Studio for why.