# BDK Native

> Reference documentation for the @bdk/native SDK — bring native iOS/Android features to any web app. Covers only the SDK's supported, customer-facing surface (the namespaced browser helpers and server helpers); internal/native-only commands are intentionally omitted.

## Getting Started
- [Get started](https://docs.native.thebdk.com/getting-started/introduction): Drive native iOS and Android features from your web app with @bdk/native.
- [Install and import](https://docs.native.thebdk.com/getting-started/installation): Install @bdk/native and pick the right import for browser or server code.
- [Set up the client](https://docs.native.thebdk.com/getting-started/initializing-the-client): Create the one client object you use for everything in the SDK.
- [Handling results](https://docs.native.thebdk.com/getting-started/interaction-models): How to read the result of a call — immediately, from an event, or as a returned value.
- [Web fallback](https://docs.native.thebdk.com/getting-started/non-native-browser): Detect when your page isn't running inside the native app and fall back to a web experience.

## Browser SDK
- [Device & lifecycle](https://docs.native.thebdk.com/browser/device-and-lifecycle): Read device info and control the native app shell — loading splash, navigation, the launch page, and cache.
- [Open links](https://docs.native.thebdk.com/browser/navigation-and-links): Open URLs, deep links, and native screens from your app.
- [Camera & media](https://docs.native.thebdk.com/browser/media): Take photos, capture a screenshot, record audio, and scan barcodes from the device.
- [Play audio & video](https://docs.native.thebdk.com/browser/media-playback): Play remote audio and video through the device's native player.
- [Geolocation](https://docs.native.thebdk.com/browser/location): Get the device's GPS position once or stream live location updates.
- [Runtime permissions](https://docs.native.thebdk.com/browser/permissions): Prompt for camera, location, or contacts before using a gated feature.
- [Biometric login](https://docs.native.thebdk.com/browser/biometrics): Prompt for Face ID, Touch ID, or fingerprint and read the result.
- [Saved login](https://docs.native.thebdk.com/browser/smart-login): Save, restore, and clear a user's email and password so returning users skip the login form.
- [In-app purchases](https://docs.native.thebdk.com/browser/in-app-purchases): Run App Store and Google Play purchase and consume flows, then read the result from an event.
- [Native UI](https://docs.native.thebdk.com/browser/ui-and-feedback): Show native banners, alerts, popups, menus, pickers, and control the status bar and orientation from your web code.
- [Native sharing](https://docs.native.thebdk.com/browser/sharing): Open the device's native share sheet to share text, images, video, files, or an Instagram Story.
- [Listen for events](https://docs.native.thebdk.com/browser/events): Most native features return their result on an event. Use bdk.on(event, listener) to subscribe.

## Server SDK
- [Server helpers](https://docs.native.thebdk.com/server/overview): Call provider APIs from your Node backend, configure credentials, inject a custom fetch, and handle errors.
- [Verify purchases](https://docs.native.thebdk.com/server/iap-verification): Verify in-app purchases server-side from any Node service.
- [Push notifications](https://docs.native.thebdk.com/server/onesignal-push): Send a OneSignal push notification from your backend.
- [Branch deep links](https://docs.native.thebdk.com/server/branch): Create a Branch deep link from your server.
- [ChottuLink deep links](https://docs.native.thebdk.com/server/chottulink): Create a ChottuLink dynamic deep link from your server.
- [Firebase Dynamic Links](https://docs.native.thebdk.com/server/firebase-dynamic-links): Create a short Firebase Dynamic Link from your server.

## Reference
- [Objects](https://docs.native.thebdk.com/reference/objects): The shape of every object the SDK returns or delivers on an event.
- [Use with AI agents](https://docs.native.thebdk.com/reference/ai-agents): Point Lovable, Cursor, Replit, and other AI coding tools at the SDK so they generate correct, secure code.