Skip to main content

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.

GroupWhat it holds
SOURCERepo, Branch and Entry, the file the app starts from
RUNTIMEType, the framework, Tier, the compute shape, Min pods and Max pods, and Storage
OWNERSHIPOwner 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.

StateWhat it saysWhere to go
BuildingYour app is buildingThe Logs tab, for progress
FailedThe last deploy failed, and the reason, which the card names rather than sending you to findThe Deploys tab, for the full log
ErrorThe app entered an error stateLogs, for details
SleepingThe app is sleeping to save costOpen the address to wake it
UnknownThe app is not runningLogs, 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.

Describes the platform as of .

Was this page helpful?