Installation

Requirements

Platform	Minimum version
iOS	13.0+
Xcode	16 minimum; 26.0+ for liquid glass support
React Native	0.76+ (New Architecture required)
Android	API 24+ (Android 7.0)
Android Gradle Plugin	8.9.1+

This library ships Fabric components only and does not support the legacy (Paper) architecture. Use React Native 0.76+ with the New Architecture enabled.

LiquidGlassView and LiquidGlassContainer need Xcode 26.0+ and iOS 26+ for the full glass effect — on older iOS versions and on Android, they automatically fall back to an enhanced blur approximation.

Install the package

npm install @sbaiahmed1/react-native-blur
# or
yarn add @sbaiahmed1/react-native-blur

iOS setup

Install pods after adding the package:

cd ios && pod install

Android setup

No additional configuration is required beyond meeting the minimum requirements:

Min SDK: API 24 (Android 7.0)
Android Gradle Plugin: 8.9.1 or newer

Check android/build.gradle if you hit a build error related to AGP:

classpath "com.android.tools.build:gradle:8.9.1" // or higher

The library depends on QmBlurView (com.github.qmdeve:qmblurview:v1.1.5, resolved from JitPack), pulled in automatically — no manual Gradle dependency setup needed.

Under the hood, Android blur is produced by capturing the view into a downsampled bitmap and applying a native blur pass. Downsampling (and the configurable blurRounds) keeps it fast across all supported API levels (24+).

Next steps

Head to BlurView for the most common component, or browse the props reference for a consolidated view of every component’s API.