🏅How to get started?

🧋 Bubble.io Plugin

We're not recommending calling any Natively 'Get Value' API in such events as "Page Is Loaded", "User is logged in" or any similar. Sometimes they can be called before Natively was injected into your website, and cause a value empty state.

If you're planning to use bubble, check out our example setup app editor: https://bubble.io/page?name=index&id=nativelyqa&tab=tabs-1

Username: 1 Password: 1

First of all, you need to add a plugin to your bubble app. To do this, go to the Plugins tab and search for Natively:

Click Install:

If you are planning to use a Push Notifications feature in your app fill out onesignal_appId & onesignal_apiKey fields:

You can find these values on your OneSignal app page:

mode (headers) - Optional

Possible values:

"debug" - show errors in the console or display error alerts (For debugging purposes)
"preview" - To test the app in a Preview mode (For now, only Push Notifications feature requires this)

"preview" should be enabled only if you're testing the app in a Preview Mode; otherwise, Push Notifications will not work inside your app.

Open Debug Console

To open Debug Console, use -> Natively - Open Debug Console action in the plugin

🛠 JavaScript SDK

Put the following code in your website header (between <head></head> tags)

<head>
<script async onload="nativelyOnLoad()" src="https://cdn.jsdelivr.net/npm/natively@2.14.0/natively-frontend.min.js"></script>
</head>

You can specify an SDK version by replacing version number 2.14.0

The latest version number can be found in this repo.

To turn on Debug mode, please insert the following code after SDK import:

<head>
<script async onload="nativelyOnLoad()" src="https://cdn.jsdelivr.net/npm/natively@2.14.0/natively-frontend.min.js"></script>
<script>
function nativelyOnLoad() {
    window.natively.setDebug(true); // To see errors
}
</script>
</head>

Debug mode which enables native alerts with errors. It's can be very useful while you developing a website.

Open Debug Console

// Make sure you have JS SDK >=v2.7.2

window.natively.openConsole();

PreviousIntegration (Native Features)NextDevice

Last updated 1 month ago

<head> <script async onload="nativelyOnLoad()" src="https://cdn.jsdelivr.net/npm/natively@2.14.0/natively-frontend.min.js"></script> <script> function nativelyOnLoad() { window.natively.setDebug(true); // To see errors } </script> </head>