Articles on: Native: Basics

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


You can keep up to 20 previews on your account. Need another one? Delete one you no longer need.


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


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

Was this article helpful?

Share your feedback

Cancel

Thank you!