For the complete documentation index, see llms.txt. This page is also available as Markdown.
🎬Preview
Test your app before committing to a paid plan - either instantly in your browser or on a real device.
What is Preview?
Preview lets you see how your app will look and behave before buying a build. Natively offers two ways to preview:
Natively Dashboard Preview - the fastest option. Renders your app in a device frame directly in the Natively Dashboard, letting you check layout and navigation instantly, without installing anything.
Natively Preview App - install the Natively Preview app on a real device to test your app more thoroughly, including a wider (but still limited) set of native features. Use this when your website can't load properly in the browser preview, or when you want to check things on an actual device.
Natively Dashboard Preview
Open your Natively app dashboard and go to Preview in the left sidebar.
Wait for your app to load in the device frame.
Use the icons on the side to switch between iOS/Android, phone/tablet, or portrait/landscape views.
Natively Dashboard Preview only supports a small set of purely visual native features - such as Bottom Bar and Style settings. Most native features, including anything requiring device hardware, permissions, or a real build, will not work here.
Open your app's dashboard and go to Preview in the left sidebar.
Scan the QR code with your phone's camera, or open the Natively Preview app directly, log in to your Natively account, and select your app.
Appearance settings you've configured (App Icon, Loading Screen, Launch Screen, Error Screen, Style) are not reflected in the Preview App.
Natively Preview app example
App opened in Natively Preview
Known limitations
Both preview methods run in a sandboxed environment. Any feature relying on native store accounts, real device signing, or server-side callbacks tied to your production app is unlikely to work correctly - even if it doesn't throw an obvious error. This applies more to Natively Dashboard Preview than the Natively Preview App, which supports a broader (though still limited) set of native features.
Features confirmed not to work in the Natively Preview App:
In-App Purchases
Deep Links
Social Auth
Background Geolocation
Analytics
HealthKit
AdMob
Calendars
Camera
Audio Recorder
Audio Player
This list reflects known limitations, not a complete guarantee. If something doesn't work as expected in either preview method, test with a full build before assuming it's broken.
