In this guide, you’ll learn how to:
  • Build and download your app for testing.
  • Trigger a new build if your app has changed.
  • Handle build failures and regenerate your build.

​
Before you begin

You’ll need:
  • An existing project in Rocket.
  • A test device or emulator (Android is supported now. iOS is coming soon).

​
Android (.apk)

1

Open your project

From your project’s dashboard, click Install on phone at the top right.
Rocket dashboard with Install on phone button highlightedRocket dashboard with Install on phone button highlighted

Install on phone option

Success check: A popup appears with Android and iOS tabs.
2

Start the build process for Android

In the popup, select the Android tab and click Download.
Android tab selected with Download button in viewAndroid tab selected with Download button in view

Build button inside Android tab

3

Track the build progress

If a new build is triggered, you’ll see a progress bar. If it takes more than a minute, you’ll receive an email when it’s ready with a link to download your app.
App build progress indicator with email notification messageApp build progress indicator with email notification message

App build in progress

4

Download your app

Once the build completes, the Download button becomes active. Click it to download the app to your device.
Download button active after app build is finishedDownload button active after app build is finished

Download active after build completes

5

Access or rebuild later

Need a fresh build after making updates? Click Build new anytime.
You can also re-download any previously built apps from the same popup.
6

Rebuild if the build fails

If the build fails, you’ll see an error message. Click Rebuild to retry the build.
App build failed message with rebuild optionApp build failed message with rebuild option

App build failed with Rebuild button

You’ll also receive an email notification when a build fails.
Troubleshooting:
Still not building? Here’s what might be causing it:
  • A package version mismatch.
  • Invalid or unsupported packages.
  • Configuration issues in your project.
  • Errors in your code.
  • Network instability during generation.
Try this first:
  • Fix any visible project errors.
  • Regenerate your app from a stable internet connection.
If the build fails three times in a row, we’re here to help. Contact us at support@rocket.new and we’ll jump in.

Got your app downloaded?
Here’s how to install it on your Android device.

​
iOS (.ipa) - Coming Soon

You did it!

Your Rocket app is built, downloaded, and ready to test. Just sideload it onto your device or emulator and go.
Need help? We’ve got your back.
Reach out to support@rocket.new or ask in our Discord community to troubleshoot or share ideas.