🖇
Create deep links for your app
Create a shareable link that will open your app to a specific screen.
A deep link is a type of link that will send the user to a specific page of a mobile app. Usually, deep links are used in QR codes or in websites. When these links are opened on a phone (browser, QR code or other method), the user will be redirected to the part of the app we specified.
On iOS, the deep link will open the app screen as a modal.
On Android, it will open the app and navigate to that screen.

🖇 Creating a deep link for your Bravo app

Once you have imported a design file into Bravo and created an app project, you can generate a deep link targeting any of the app pages. To do that, go to Settings > Deep Links.
To generate a deep link, you'll need to specify the following values:
  • Deep Link Name: the name for the deep link you'll generate. You can use any name you prefer. Later on, the latest generated deep links will appear in the panel, identified with the name you set here.
  • URL copied from Bravo Vision: here, you'll specify the app page you want to target with the deep link. To get this URL, you need to open the app in Bravo Vision, go to the desired page, long press, and select Copy page URL, as indicated here.
  • URL to open from desktop: in case the deep link is opened from a desktop device instead of a mobile phone, the URL specified here will be opened. You can set it to whatever webpage you wish. Remember to provide the complete webpage URL (including https://).
You'll see the Create live app link button disabled, as you'll need to set up a Firebase project and provide some assets to be able to generate this link. This will be covered later in this guide.

📲 Creating a deep link for a Bravo Vision app

With the information you've already provided, you'll be able to create a deep link targeting an app in Bravo Vision. To create the link, click on Create Bravo Vision link inside the Deep Links section, in the app settings.
Once the link is created, it will appear under Generated deep links (last 10).
Now, you'll be able to get the QR code for that deep link, by clicking on the eye icon. Alternatively, you can copy the link in text format, by clicking on the icon in the left.
To test it, make sure the app is opened on Bravo Vision, in the mobile device where you're going to test the deep link. Otherwise, the link won't work.
To open the link in your mobile device, simply send it in text format via your preferred method (email, messaging, notes...) or scan the QR code.

🌏 Creating a deep link for a published app

In case you're about to publish your app to the stores, or test it with Testflight / debug APK, you can generate a deep link targeting it. You'll need to follow these steps before generating the app bundle. In case you've already generated it, you'll need to request a new one after finishing these configuration steps.
First, you need to set up a Firebase Dynamic Links project. Go to Firebase, and create a new project inside your account (You need a Google account first). Inside the project, go to Engage > Dynamic Links.
Inside this page, you'll be asked to add a URL prefix. Input a name of your choice for that. Once you finish typing, you'll see the option to choose the Google provided domain, which is the recommended way to set the URL prefix.
Click on it, and choose Continue for all the other steps.
Once you've created your URL prefix, it will appear inside the Dynamic Links section in Firebase. Now, you need to complete the following steps to obtain some assets that we'll provide later inside the Bravo Studio settings:
  • In your Firebase project, go to Build > Authentication. Here, add a sign-in method. You can use, for instance, email / password. Although we don't need to set up any authentication in our app to use deep links, this configuration will generate a web API key that will appear inside the Firebase project settings, and we'll need to copy into the Bravo settings.
  • Go to the Firebase project settings, and create an app for both iOS and Android. Here, we'll need to provide both an Apple bundle ID and an Android package name. These names need to be the same ones specified when generating the app bundle for publication. Leave all the other fields in the app generation menu as they are.
After completing those steps, go back to the Deep Links settings inside Bravo. Go to Firebase settings, and provide the following information:
  • Web API key: copy this from your Firebase project settings. If you see the message "No web API key for this project", indicate an Authentication method as described before.
  • URL prefix: this is the URL prefix indicated in Firebase before. In case it's a Google domain, it will end in .page.link. Copy it from Firebase and paste it here.
  • Android Package Name: the package name for the Android app, specified in Firebase.
  • iOS Package Name: the bundle ID for the iOS app, specified in Firebase.
  • App Store ID: in case you have published the app for iOS, copy this value from the App Store Connect portal, under App Information. The app doesn't need to be published, only created in App Store Connect.
    Once you've set these values, click Save. Finally, go to the Generate links section, fill in the Deep Link Name and URLs, and click on Create live app link. You'll obtain a deep link that you can test on a mobile device with the target app installed. You can test it via QR code, or copying the link URL in text, and opening it from the mobile device.
In case the Create live app link button is disabled, go through the Firebase configuration steps and make sure you provided the right values inside the Firebase settings section.
Once you've indicated these settings, you can go ahead and request your app bundle.
If you already have a published app bundle, and you change these settings afterwards, you'll need to generate a new bundle and publish an update to the stores.