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 generate a new 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 the project dashboard, click Launch in the top-right corner.
Rocket project dashboard showing the Launch button in the top-right corner.Rocket project dashboard showing the Launch button in the top-right corner.

Launch your project

Success check: A popup appears with Android and iOS options under ‘Install on Phone’.
2

Start the Android build

In the popup, select the Android option and click Build.
Android build option selected with Build button visible.

Start build for Android

3

Track the build progress

When a build starts, you’ll see a progress bar.
If it takes more than a minute, Rocket will email you a download link once the build is ready.
Progress indicator during Android app build with message about email notification.

App build in progress

4

Download your app

Once the build finishes, the Download button becomes active. Click it to download the .apk file to your device.
Active Download button available after successful Android build.

Download the .apk file

5

Rebuild or redownload

Need to test updates? Click Build new to trigger a fresh build.
You can also re-download previously built apps from the same popup.
6

Fix build errors and retry

If your build fails, you’ll see an error message with a Rebuild option.
Build failed message with Rebuild button shown.

Build failed with retry option

You’ll also get an email if the build fails.
Troubleshooting:
If the build still doesn’t work, it could be due to:
  • Version mismatch in dependencies
  • Unsupported or broken packages
  • Invalid project configurations
  • Errors in your code
  • Poor network connection during build
Try this first:
  • Fix any project errors you see.
  • Ensure you’re on a stable internet connection.
  • Click Regenerate to start a clean build.
If it fails three times in a row, reach out to support@rocket.new. We’ll help you sort it out.

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

​
iOS (.ipa) – Coming Soon

Note: App downloads are available to paid users only.

You did it!

Your Rocket app is built, downloaded, and ready to test. Sideload it onto your Android device or emulator and start exploring.
Need help? We’ve got your back.
Reach out to support@rocket.new or ask in our Discord community for quick answers or advanced help.