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.
BlurView blurs the content rendered behind it — the backdrop — not its own children. Place it over images, maps, or any view and it will apply a live, compositor-driven blur using UIVisualEffectView on iOS (with all 21 system materials) and a custom Gaussian renderer on Android. It is the right choice for headers, tab bars, floating action bars, modal backgrounds, and bottom sheets wherever you want the classic frosted-glass effect.
Basic Usage
basic-blur-view.tsx
Props
Blur strength from
0 (no blur) to 100 (maximum blur). Maps to the blur radius used by the
underlying renderer. On Android, use blurReductionFactor to calibrate the perceived intensity
against iOS.The system material washed over the blur layer. Accepts any of the 21 iOS system material tokens
such as
"systemThinMaterial", "systemChromeMaterialDark", or the legacy "light" / "dark"
values. See Tints & Materials for the full list.A custom colour applied over the blur, replacing
tint when set. Use this when none of the
system materials match your design. Accepts any React Native ColorValue string — hex, rgba,
named colours, etc.Set to
false to disable blurring entirely and render only the tint overlay. Useful for
conditional degraded states or accessibility preferences.Uniform corner radius applied to the blur layer and its children. Clips both, so you do not
need a separate
overflow: 'hidden' wrapper. See Corner Radii for
per-corner control.Per-corner radii object with optional keys
topLeft, topRight, bottomRight, and
bottomLeft. When both cornerRadius and cornerRadii are set, cornerRadii takes
precedence. See Corner Radii for details and examples.Style applied to the outer container view. Use this to set dimensions, margins, padding, and
position — the blur fills the container automatically.
Content rendered on top of the blur layer. Children are not blurred — they sit above the
frosted surface.
Divides the radius that
intensity maps to before it is passed to the Android renderer. Android
blur reads stronger than iOS at the same intensity value, so this is the main dial for matching
them visually.Android only — iOS ignores this prop.
Explicit blur radius in dp, bypassing the radius derived from
intensity. Use when you need an
exact, design-spec radius independent of the intensity scale. iOS has no equivalent because
UIVisualEffectView fixes the radius per material.Android only — iOS ignores this prop.
How much the backdrop image is downsampled before the blur pass. Higher values are cheaper and
produce a softer result. Leave at
0 to let the native layer derive a factor automatically from
the blur radius.Android only — iOS ignores this prop.
Number of blur passes applied to each captured frame. More passes produce a softer result at a
roughly linear performance cost.
Android only — iOS ignores this prop.
Whether the backdrop re-captures every rendered frame. Set to
false to freeze the backdrop
capture over static content, saving GPU work. On iOS the compositor handles backdrop capture
automatically and this prop has no effect.Android only — iOS ignores this prop.
When to Use BlurView
- Navigation headers — float a blur bar over a
ScrollVieworFlatListso content scrolls under a frosted header. - Tab bars — match the native iOS tab bar look with
systemChromeMaterial. - Floating panels and cards — overlay contextual controls without a solid background.
- Modal and sheet backgrounds — give bottom sheets and alerts a translucent, layered feel.
- Bottom sheets — keep the screen context visible while a sheet is presented.
Further Reading
- Tints & Materials — full list of every
BlurTintvalue and which iOS material each maps to. - Corner Radii — uniform and per-corner clipping with
cornerRadiusandcornerRadii. - Android Tuning — matching iOS blur strength on Android with
blurReductionFactor,downsampleFactor, andblurRounds. - Animations — using
Animated.createAnimatedComponentand Reanimated to animateintensityand other props.