Skip to main content
We recommend testing your mobile app by publishing it to a Hercules domain, then installing it on your mobile device
1

Publish your app

Click Publish to get a live URL. You need a published URL to test the real mobile experience.
Publish an app in Hercules
2

Open on your phone

Open the published URL in your phone’s browser (e.g. Safari on iOS, Chrome on Android).
3

Install to home screen

Use your browser’s Add to Home Screen option to install the app: - Safari (iOS): Tap the Share button, then scroll down and tap “Add to Home Screen” - Chrome (Android): Tap the menu (three dots), then tap “Add to Home screen” or “Install app”
4

Launch from home screen

Open the app from your home screen to test the full installed experience: splash screen, full-screen mode, and app icon.

​
How do I test updates?

After making changes to your app, fully quit and re-open it from your home screen to see the updates. Simply switching apps may show cached content.

​
Why can’t I test in the Hercules preview?

The Hercules preview does not support mobile-specific functionality like push notifications, location, etc. You must test on a mobile device.

​
I see “dev machine not found” when installing the PWA

You can’t install the PWA from inside the Hercules preview (iframe). Install it from the published URL instead:
  1. Click Publish.
  2. Open the publish URL on your device.
  3. Install the PWA from there (Add to Home Screen).