Release 5.0.0

5.0.0 (2026-07-29)

💥 Breaking changes

New Architecture is now required

The library ships Fabric components only and no longer includes the legacy (Paper) view managers. You must be on React Native 0.80+ with the New Architecture enabled.

peerDependencies now require:

Package	Range
react-native	>= 0.80.0
react	>= 18.2.0

The 0.80 floor comes from the codegen specs importing codegenNativeComponent from the react-native root (the deep react-native/Libraries/... import paths are deprecated), which older versions don't export.

There is no code change to make in your app beyond being on a supported New Architecture setup — if you were already on it (which prior versions effectively required), nothing else changes.

Raw native components are deprecated

The raw ReactNative* codegen components (ReactNativeBlurView, ReactNativeLiquidGlassView, and friends) are still exported but now marked @deprecated and will be removed in a future major. Always use the wrapper components (BlurView, LiquidGlassView, …), which handle platform fallbacks, defaults and refs:

// ❌ Deprecated — do not import the raw native component
import { ReactNativeBlurView } from '@sbaiahmed1/react-native-blur';

// ✅ Use the wrapper instead
import { BlurView } from '@sbaiahmed1/react-native-blur';

Android: BlurSwitch blur strength

On Android, BlurSwitch now maps blurAmount to the same strength as BlurView and ProgressiveBlurView (previously it rendered a weaker blur for the same value). If you tuned blurAmount on a BlurSwitch for a specific look, re-check it.

✨ New

• Ref forwarding — BlurView, ProgressiveBlurView, VibrancyView, LiquidGlassView and LiquidGlassContainer now forward a ref to their underlying native view (on the primary platform path).
• react-native-web support for all components.

📦 What's Changed

• fix(android): stop losing view state on detach/re-attach + correctness (audit PR 1/6) by @sbaiahmed1 in #120
• fix(ios): liquid-glass accessibility, tint, corners, child mount (audit PR 2/6) by @sbaiahmed1 in #121
• fix(ios): self-healing, animator contract, recycle, effect coalescing (audit PR 3/6) by @sbaiahmed1 in #122
• fix: align codegen contract across native and JS (audit PR 4/6) by @sbaiahmed1 in #123
• refactor(ts): forwardRef + memo, deprecate raw exports, add tests (audit PR 5/6) by @sbaiahmed1 in #124
• chore: new-arch-only, packaging, docs and hygiene (audit PR 6/6) by @sbaiahmed1 in #125
• docs: delegate README to website + document v5 breaking changes (audit PR 7/7) by @sbaiahmed1 in #126
• feat(web): add react-native-web support for all components by @sbaiahmed1 in #127
• v5 beta.1 prep: QmBlurView 1.3.0, RN 0.80 floor, Android modal overlay fix by @sbaiahmed1 in #128

Full Changelog: v4.7.1...v5.0.0