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.

With view: "website", iOS opens an in-app browser sheet and Android hands the URL to the device's default browser.

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"
});

Present another page over the current one without losing its state. Pass transition: "modal"; modal_style is sheet or fullscreen (default sheet), and modal_detent is large or medium (default large, sheets only). Close dismisses the whole modal; Back pops pages inside it.

await bdk.navigation.navigate({
  url: "https://example.com/checkout",
  transition: "modal",
  modal_style: "sheet",
  modal_detent: "medium"
});

Older app builds open it as a normal page. Where the platform offers only fullscreen (Android today), a sheet request presents fullscreen.

The page that opened the modal receives navigation.dismissed once after it closes. Subscribe before you call. The payload is a NavigationDismissedEvent.

bdk.on("navigation.dismissed", (event) => {
  console.log(event.reason, event.url);
});

await bdk.navigation.navigate({
  url: "https://example.com/checkout",
  transition: "modal",
  modal_style: "sheet",
  modal_detent: "medium"
});

These calls resolve to a NativeCommandResult (see Handling results for its fields). Outside the app triggered is false — use that to fall back to ordinary web navigation.

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

if (!result.triggered) {
  window.open("https://example.com/pricing", "_blank");
}

Open a link

Navigate within the app

Open a page as a modal

Know when a modal closes

Fall back to web navigation