> ## Documentation Index
> Fetch the complete documentation index at: https://hercules.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Test Your Mobile App

> Test your mobile app on a real phone: publish to a Hercules domain, open the URL on your phone, and install it from the browser with Add to Home Screen.

Test your mobile app on a real phone. Publish it to a [Hercules domain](/docs/apps/publish/hercules-domain), then install it from your phone's browser.

<Steps>
  <Step title="Publish your app">
    Click **Publish** to get a live URL. You need a published URL to test the real mobile experience.

    <div className="screenshot purple">
      <img src="https://mintcdn.com/zeus-0f6dadbf/vyfZOWPi9KdyCPiO/images/apps/publish-my-app.png?fit=max&auto=format&n=vyfZOWPi9KdyCPiO&q=85&s=b2c1f799c114e72d1c46a1796dcb6475" alt="Publish an app in Hercules" width="832" height="416" data-path="images/apps/publish-my-app.png" />
    </div>
  </Step>

  <Step title="Open on your phone">
    Click **Mobile** and copy your app URL under **Install it on your phone**. Open it in your phone's browser (Safari on iPhone, Chrome on Android).
  </Step>

  <Step title="Install to home screen">
    * **iPhone:** in Safari, tap **Share**, then **Add to Home Screen**
    * **Android:** in Chrome, tap the menu (three dots), then **Install app** or **Add to Home screen**
  </Step>

  <Step title="Launch from home screen">
    Open the app from your home screen to test the installed experience: splash screen, full-screen mode, and app icon.
  </Step>
</Steps>

### How do I test updates?

After you publish changes, fully close the app and open it again from your home screen. Switching between apps can keep showing the old version.

### Why can't I test in the Hercules preview?

The Hercules preview does not support phone features like push notifications or location. Test on a real phone.

### I see "Dev Machine Not Found" when installing the PWA

You can't install the PWA from inside the Hercules preview. Install it from the published URL instead:

1. Click **Publish**
2. Open the published URL on your phone
3. Install the PWA from there (Add to Home Screen)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.