Open links

Open URLs, deep links, and native screens from your app.

Open a link

Open a URL in an in-app web view, an external app, or a native screen. Set view to choose the destination. URLs are normalized by default (missing https:// is added, urlParams applied); pass useRawLink: true to skip that.

Property	Type	Description
`link`	`string` · required	The URL to open.
`view`	`string`	Where to open it: `website`, `another app`, or `another screen`.
`transition`	`string`	The screen transition animation.
`useRawLink`	`boolean`	Open the link exactly as given, skipping URL normalization.
`urlParams`	`UrlParam[]`	Query parameters to append to the URL. Each is `{ key, value }`.

await bdk.navigation.openLink({
  link: "https://example.com/pricing",
  view: "website"
});

Navigate within the app

Move to another screen inside the app.

Property	Type	Description
`url`	`string` · required	The in-app screen to move to.
`baseUrl`	`string`	The app's base URL, used to resolve relative links.

await bdk.navigation.navigate({
  url: "https://example.com/account",
  baseUrl: "example.com"
});

These calls resolve to a NativeCommandResult (see Handling results for its fields). Outside the app the result comes back skipped or pending — use that to fall back to ordinary web navigation.

const result = await bdk.navigation.openLink({
  link: "https://example.com/pricing",
  view: "website"
});

if (result.skipped || result.pending) {
  window.open("https://example.com/pricing", "_blank");
}

Open a link

Navigate within the app

Fall back to web navigation