Previews
Open a running preview of what a cloud thread built — a site, an app, or a phone app in Expo Go — and fix a preview that won't start or open.
On this page
A preview is the thread's project running, so you can use it before delivering it: a site, a web app, or a phone app on your own phone. Previews are for threads in Ysra's cloud; on your computer, the app runs on your own machine. This page explains the three kinds, the states, and what to do when one doesn't open.
The rule#
A preview runs only while someone looks at it. It starts on Start preview (or when you ask for it in the thread, which is never charged as a change), and stops by itself after 15 minutes with nobody looking.
Kinds of preview#
| Kind | What runs | Address |
|---|---|---|
| Site | A static site (HTML, CSS, JavaScript). No machine needed. | s-<thread>.ysra.run |
| App | A web app with a server, on the thread's cloud machine. | A private ysra.run address for this thread |
| Phone app | An Expo app, opened in Expo Go on your phone from a QR code, plus a web version in a phone frame. | An exps:// link only you get |
Previews open through Ysra only, on a private link signed for you that lasts 12 hours. The cloud machine's own address isn't public: someone who finds it can't open your app. A phone link works only while the machine runs.
States#
| State | What it means | What moves it on |
|---|---|---|
| Nothing running yet | Never started in this thread. | Start preview |
| Starting | Restoring the files, installing, starting the app. | It answers → Running; or it doesn't → Didn't start |
| Running | Up and answering. | Stop, 15 minutes idle, the machine needed for a task, or the plan's time limit |
| Stopped | Stopped by you, by idleness, by a task, or by the time limit. The message says which. | Start preview again |
| Didn't start / the app stopped | The app exited or never answered. The last log lines are shown. | Ask Ysra to fix it (a paid change), or start again |
Phone apps and the Expo SDK#
Expo Go, the app on your phone, opens only projects made for the SDK it runs. Ysra reads the SDK of the phone that scanned the QR code and compares it with the project's.
| Situation | What the preview says | What to do |
|---|---|---|
| Phone's Expo Go is newer than the app | "Your phone's Expo Go runs SDK N; this app uses SDK M, so Expo Go won't open it. Move the app to SDK N." | Move to SDK N |
| Phone's Expo Go is older than the app | "… uses the newer SDK M. Update Expo Go from the App Store or Play Store, or move the app to SDK N." | Update Expo Go, or Move to SDK N |
| No phone has scanned yet, and the app's SDK differs from the stores' Expo Go | "This app uses Expo SDK M … Ask me to move it to SDK N." | Scan first: your phone decides |
| The app was started a way a phone can't reach | "This phone app was started in a way a phone can't reach …" | Ask Ysra to restart Expo through Ysra |
Move to SDK N asks Ysra (a paid change) to move the project to that SDK, run Expo's own checks, fix what breaks, check the app and restart the preview. Two phones on different SDKs can't both open one project: move it to the SDK of the phone you test with.
When a preview won't open#
| Symptom | Why | What to do |
|---|---|---|
| "The preview didn't start in 3 minutes." | The app is slow to start, or waits for something it can't reach. | Read the last lines shown, then Ask Ysra to fix it. |
| "The app stopped. Here are its last lines." | The app crashed. | Ask Ysra to fix it. |
| It stopped by itself | 15 minutes with nobody looking, a task took the machine, or the plan's time limit. | Start preview again. |
| Expo Go says the project is incompatible | The SDKs differ. | See Phone apps and the Expo SDK. |
| The link worked yesterday, not today | Links last 12 hours. | Open the preview from the thread again. |
Download the project#
Download project gives the thread's latest saved files as a zip, without
.git or installed packages. It's for threads in Ysra's cloud; on your
computer the files are already yours.
Limits#
| Limit | Value |
|---|---|
| Stops with nobody looking | After 15 minutes |
| Waits for the app to answer | 3 minutes |
| Longest a preview stays up | The plan's longest task (at least 10 minutes) |
| Preview link | 12 hours |
Related#
- How a Code thread works — tasks, checks and what is kept.
- In Ysra's cloud — cloud threads and machines.
- Publish or Deploy — putting it online for others.
- Limits and costs — cloud time and plan limits.