What is the Preview Mode and how do I use it
What is the Preview Mode
Preview lets you see your own bubble app running as a native app on your own phone, before you buy your own app build from us. It's free, and it runs in our BDK Preview app.
You can even build the native workflows and test them before ordering your app build. Just install the Native apps (bdk) plugin from the bubble plugin store ($3 one-time, prices as of 19 October 2026).
That's awesome. How do I preview my bubble app
- First, install the free BDK Preview app on your phone. On Android it's on Google Play. On iPhone it installs through TestFlight, and the page shows you the two taps.
- Then, on thebdk.com, paste your bubble app's link to make a preview. You can create an account for free.
Provide Your Webpage link
- Enter your bubble site url (not the bubble editor url). Just like you would in a web browser to visit the page.
- For example https://yourapp.bubbleapps.io/pagename or https://yourappdomain.com/pagename (if your bubble app is linked to domain)
- It must be a published address of your app. If it isn't, we'll tell you and suggest the right link
- No need to enter the app domain anymore. We work it out from your link
Open it on your phone
- Tap Launch on thebdk.com. You'll get an 8-character code and a QR code
- Enter the code in BDK Preview (or scan the QR code), and your app opens
- The code signs in to your account, so use it only on your own phone
Is your bubble app password protected?
- No need to remove the password. Mark the preview as password protected on thebdk.com and save the test username & password there
Can I show my preview to others
- Yes, on Android and on the web. People you invite open your preview in BDK Preview on Android, or on the web
- On iPhone, BDK Preview opens only the previews on your own BDK account
What preview can't show you
- Native features that need no outside account work just like they will in your own build
- Your own app icon. In preview, it's BDK Preview's icon on your home screen. Your own build has your icon and name
- Push notifications and deep links in preview run on our accounts, and deep links made in preview carry our branding. In your own build, they're all yours
- In-app purchases work only with our own sample products, not yours
- Preview doesn't prove your production setup (like sign-in providers, your push keys or your deep links), and it can't predict store approval. That's Apple's and Google's call
How do I change that loading screen and status bar color
Design loading screen
- Our default loading screen shows up while your bubble page finishes loading behind it.
- You can design your own in the Loading Screen Designer on thebdk.com, to get a better feel.
- When you start your bdk native project, you design the splash, loading and transition screens for your own app build the same way.
Update status bar color
- You can update the status bar color at any time in your bubble page by using the workflow step 'BN - Update Status Bar color' as per the plugin documentation
Do I need to keep deploying my changes live to test
No you don't
- Just use the version-test link of your page as the preview link.
- You can also provide additional data as url parameters e.g. https://yourappdomain.com/version-test/yourpagename?myname=gaurav
Do I always have to use preview for testing
Once you order your own app build, you can directly use that for testing instead of a preview!
Can I test my app build before submitting to Apple and Google for review
Yes you can!
- Like every other native app, you will be able to test your app on your devices, beta testers etc. (TestFlight on iOS, a testing track in Play Console on Android)
- When you're done testing, you submit the build along with your other business & marketing information (e.g. screenshots, T&C, app description etc.) to Apple and/or google for review, from your own accounts
- Apple has a testing period limitation of 90 days per build. So to avoid using up a rebuild, we recommend you use preview for testing your app until you are less than 90 days from your targeted launch date
Updated on: 11/04/2026
Thank you!