> For the complete documentation index, see [llms.txt](https://help.twinr.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.twinr.dev/create-app/preview-app.md).

# Preview App

Open your app on a real phone and watch your changes appear as you make them.

The portal shows you a phone-shaped preview as you work, but it is still a browser. To see your app as your customers will — real gestures, real push notifications, your own icon on the home screen — open it on a phone with the **Twinr Preview** app.

You do not have to publish anything to do this. Preview runs your app live, from your drafts.

## Get the Preview app

Click **Preview** on any app card. Twinr shows you the download codes for both stores.

<figure><img src="https://3731994945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlBy5z08zL1UoCwNqmg%2Fuploads%2Fgit-blob-a047772c257885dd2fc049b121ff72e597d1586a%2Fpreview-app-dialog.png?alt=media" alt="The Twinr Preview App dialog with Google Play and App Store QR codes and download badges"><figcaption></figcaption></figure>

Scan the code for your phone, or search for **Twinr** in the store:

* **Android** — [Google Play](https://play.google.com/store/apps/details?id=com.twinr.builder.previewer)
* **iPhone and iPad** — [App Store](https://apps.apple.com/ca/app/twinr/id6446420501)

## Open your app

1. Sign in to the Preview app with the same email and password you use for the Twinr portal.
2. Pick the app you want to see from your list.

Your app opens on the phone exactly as it is configured right now.

## See your changes

Changes you make in the portal do not appear on the phone by themselves. Each time you want to see your latest work:

1. Click **Save as draft** in the portal.
2. Pull down to refresh in the Preview app, or use the refresh button.

{% hint style="info" %}
**The floating button is not part of your app.** The small circular button you see while previewing is there to refresh and go back. It belongs to the Preview app and will not appear in the app your customers download.
{% endhint %}

## Common Questions

<details>

<summary>Do I need to publish my app to preview it?</summary>

No. Preview reads your drafts, so you can try things out long before you submit anything to the stores.

</details>

<details>

<summary>My changes aren't showing up.</summary>

Save as draft in the portal first, then refresh in the Preview app. Changes do not sync on their own.

</details>

<details>

<summary>Can someone else preview my app?</summary>

Yes, as long as they are a member of your organization and sign in to the Preview app with their own Twinr account.

</details>

<details>

<summary>Will push notifications work in preview?</summary>

Yes. Notifications sent to the preview arrive on the phone like any other, which makes it the easiest way to check how yours look.

</details>