TypeScript MIT

react-native-blur

A modern React Native blur view component that provides native blur effects for both iOS and Android platforms. also adds progressive blur and liquidGlass

S

sbaiahmed1

Dernière activité 20 sept. 2026
sbaiahmed1/react-native-blur

345

étoiles

19

forks

3

issues ouvertes

android-blurblur-effectblurviewliquid-glassliquid-glass-containerliquidglassliquidglassreactprogressive-blurreact-native-blurvisualeffectview

Ce README est souvent en anglais.

@sbaiahmed1/react-native-blur

Native blur, vibrancy, and iOS 26 liquid-glass effects for React Native — on iOS, Android, and Web. Six focused components: BlurView, ProgressiveBlurView, VibrancyView, LiquidGlassView, LiquidGlassContainer, and BlurSwitch. Built for the New Architecture (Fabric).

npm version downloads per month license stars

New Architecture Liquid Glass

📖 Documentation

Full documentation, guides, and the complete API reference live on the docs site:

⚠️ v5 is New Architecture only (React Native 0.80+) and drops legacy Paper support. See Migration & breaking changes.

Demo

iOS Demo Android Demo
iOS (left) and Android (right) blur effects in action

Features

  • Six focused components for blur, vibrancy, progressive/gradient blur, liquid glass, and a blurred switch.
  • True native effects: UIVisualEffectView / UIGlassEffect on iOS, hardware-accelerated blur and liquid glass on Android.
  • Web support out of the box (Expo Web / react-native-web) via CSS backdrop-filter, including a real progressive-blur ramp.
  • Native liquid glass on iOS 26+ and Android 13+, with automatic fallback to an enhanced blur on older iOS, older Android, and Web.
  • New Architecture (Fabric) components with full TypeScript types.

Requirements

Platform Minimum version
iOS 13.0+ (Xcode 16; 26.0+ for liquid glass)
React Native 0.80+ (New Architecture required)
Android API 24+, AGP 8.9.1+ (API 33+ for liquid glass)
Web react-native-web (blur needs backdrop-filter)

Installation

yarn add @sbaiahmed1/react-native-blur
# then, for iOS:
cd ios && pod install

Requires React Native 0.80+ with the New Architecture enabled. Full setup notes: Installation docs.

Quick start

import { BlurView } from '@sbaiahmed1/react-native-blur';

<BlurView blurType="light" blurAmount={20} style={{ flex: 1 }}>
  <Text>Content on top of blur</Text>
</BlurView>;

Every component, prop, and platform note is documented on the docs site.

Contributing

See CONTRIBUTING.md. The documentation site lives in website/ — when you change the public API, update the website in the same pull request.

License

MIT

Credits

Built with create-react-native-library. Android blur is powered by QmBlurView; Android liquid glass by the AndroidLiquidGlassView shader (both by QmDeve, MIT).

Projets similaires

React Native Blur component

TypeScriptreact-nativereact-native-blurreact-native-component
Mmargelo
3,9 k étoiles565

✨ iOS-like progressive blur effect for React Native

TypeScript
Rrit3zh
272 étoiles13

Dynamic iOS-like blur of underlying Views for Android

Javaandroidblurblurview
DDimezis
4,1 k étoiles379