# Preview on mobile

You can preview your scene directly on the Decentraland mobile app from the Creator Hub or from the command line. This is the only reliable way to confirm that your UI, input handling, and performance hold up on a real device.

## Prerequisites

* The Decentraland mobile app installed on your phone — see the [download links](/creator/scenes-sdk7/building-for-mobile/building-for-mobile.md#get-the-mobile-app).
* The phone and your development machine must be on the **same local network** (Wi-Fi). The preview is served from your computer; the QR code links to a LAN URL.

## Option A — From the Creator Hub

1. Open your scene in the Creator Hub.
2. Click the dropdown next to the **Preview** button and choose **Show QR Code for Mobile**.
3. Scan the displayed QR code with your phone's camera. The link opens the Decentraland mobile app and loads your scene preview.

<figure><img src="/files/E7SPhptgmxf1PqgGlNRK" alt="Creator Hub preview dropdown with the Show QR Code for Mobile option"><figcaption><p>The "Show QR Code for Mobile" option in the Creator Hub preview dropdown.</p></figcaption></figure>

## Option B — From the command line

From the root of your scene project, run:

```bash
npm run start -- --mobile
```

The CLI prints a QR code in the terminal that points to your scene's LAN URL. Scan it with your phone to load the scene in the Decentraland mobile app.

<figure><img src="/files/8t7YWuSRddDivutiLy9J" alt="QR code printed by the Decentraland CLI for mobile preview"><figcaption><p>A QR code printed by <code>npm run start -- --mobile</code>. Scan it with your phone to open the scene in the Decentraland mobile app.</p></figcaption></figure>

{% hint style="info" %}
**💡 Tip**: When you pass `--mobile`, the desktop explorer is not also launched. If you want to test on both at once, run `npm run start` in one terminal for desktop and `npm run start -- --mobile` in another for mobile.
{% endhint %}

## Hot reload

Just like with desktop preview, the mobile preview reloads automatically when you change scene files. You don't need to re-scan the QR code after every edit.

## Troubleshooting

* **QR code doesn't open the app** — make sure the Decentraland app is installed and that you've opened it at least once on the device.
* **Phone can't reach the preview server** — confirm the phone and the dev machine are on the same Wi-Fi network. Some corporate networks isolate clients; use a personal hotspot or a different network if so.
* **Scene loads on the phone but looks different from desktop** — that is expected. Use this as the moment to validate your [safe area](/creator/scenes-sdk7/building-for-mobile/safe-area.md), [UI sizing](/creator/scenes-sdk7/building-for-mobile/ui-best-practices.md#sizing), and [input bindings](/creator/scenes-sdk7/building-for-mobile/input-on-mobile.md).

## Related

* [Preview Your Scene](/creator/scenes-sdk7/getting-started/preview-scene.md)
* [Using the CLI](/creator/scenes-sdk7/getting-started/using-the-cli.md)
* [Get featured on mobile Discover](/creator/scenes-sdk7/building-for-mobile/get-featured.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.decentraland.org/creator/scenes-sdk7/building-for-mobile/preview-on-mobile.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.