Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/rit3zh/expo-backdrop/llms.txt

Use this file to discover all available pages before exploring further.

expo-backdrop includes native iOS (Swift) and Android (Kotlin) code that is compiled directly into your app binary. This means it cannot run inside Expo Go — you need either a development build or a bare workflow project. The steps below walk you through installing the package, triggering a prebuild to generate the native project files, and running the app on a simulator or physical device.
Expo Go is not supported. Attempting to use expo-backdrop inside Expo Go will result in a runtime error because the native modules are not present in the Expo Go binary.

​
Requirements

  • Expo SDK — any version that supports Expo Modules (SDK 46+).
  • iOS 13+ — required for both BlurView and GaussianBlurView.
  • Android — BlurView works on all versions supported by your Expo SDK target; GaussianBlurView requires API 31 (Android 12)+.
  • Web — not supported; both components throw an error if rendered on web.

​
Steps

1

Install the package

Add expo-backdrop to your project using your preferred package manager.
npm install expo-backdrop
2

Prebuild your project

Generate (or regenerate) the native iOS and Android project files so the new module is linked into your app binary.
bunx expo prebuild
You can also use npx if you are not using Bun:
npx expo prebuild
If you have already prebuilt your project before, you do not need to run prebuild again — just re-run bunx expo run:ios or bunx expo run:android after installing the package and the module will be picked up automatically.
3

Run on iOS

Build and launch the app on an iOS simulator or connected device.
bunx expo run:ios
4

Run on Android

Build and launch the app on an Android emulator or connected device.
bunx expo run:android

Build docs developers (and LLMs) love

Get started for freeTalk to us