Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

expo-blur

expo1.9mMIT14.1.5TypeScript support: included

A component that renders a native blur view on iOS and falls back to a semi-transparent view on Android. A common usage of this is for navigation bars, tab bars, and modals.

react-native, expo, expo-blur

readme

Expo logo

Expo

Expo SDK version Chat or ask a question License: MIT Downloads

Try Expo in the Browser  •  Read the Documentation  •  Learn more on our blog  •  Request a feature

Follow us on

Expo on X   Expo on GitHub   Expo on Reddit   Expo on Bluesky   Expo on LinkedIn

Introduction

Expo is an open-source platform for making universal native apps that run on Android, iOS, and the web. It includes a universal runtime and libraries that let you build native apps by writing React and JavaScript.

This repository includes the Expo SDK, Modules API, Go app, CLI, Router, documentation, and various other supporting tools. Expo Application Services (EAS) is a platform of hosted services that are deeply integrated with Expo open source tools. EAS helps you build, ship, and iterate on your app as an individual or a team.

Read the Expo Community Guidelines before interacting in the repository. Thank you for helping keep the Expo community open and welcoming!

Table of contents

📚 Documentation

Learn about building and deploying universal apps in our official docs!

🗺 Project Layout

  • packages All the source code for Expo modules, if you want to edit a library or just see how it works this is where you'll find it.
  • apps This is where you can find Expo projects which are linked to the development modules. You'll do most of your testing in here.
  • apps/expo-go This is where you can find the source code for Expo Go.
  • apps/expo-go/ios/Exponent.xcworkspace is the Xcode workspace. When developing iOS, always open this instead of Exponent.xcodeproj because the workspace also loads the CocoaPods dependencies.
  • docs The source code for https://docs.expo.dev
  • templates The template projects you get when you run npx create-expo-app
  • react-native-lab This is our fork of react-native used to build Expo Go.
  • guides In-depth tutorials for advanced topics like contributing to the client.
  • tools contain build and configuration tools.
  • template-files contains templates for files that require private keys. They are populated using the keys in template-files/keys.json.
  • template-files/ios/dependencies.json specifies the CocoaPods dependencies of the app.

🏅 Badges

Let everyone know your app can be run instantly in the Expo Go app!

runs with Expo Go

runs with Expo Go

[![runs with Expo Go](https://img.shields.io/badge/Runs%20with%20Expo%20Go-000.svg?style=flat-square&logo=EXPO&labelColor=f3f3f3&logoColor=000)](https://expo.dev/client)

[![runs with Expo Go](https://img.shields.io/badge/Runs%20with%20Expo%20Go-4630EB.svg?style=flat-square&logo=EXPO&labelColor=f3f3f3&logoColor=000)](https://expo.dev/client)

👏 Contributing

If you like Expo and want to help make it better then check out our contributing guide! Check out the CLI package to work on the Expo CLI.

❓ FAQ

If you have questions about Expo and want answers, then check out our Frequently Asked Questions!

If you still have questions you can ask them on our Discord and Forums or X @expo.

💙 The Team

Curious about who makes Expo? Here are our team members!

License

The Expo source code is made available under the MIT license. Some of the dependencies are licensed differently, with the BSD license, for example.

Star the Expo repo on GitHub to support the project

changelog

Changelog

Unpublished

🛠 Breaking changes

🎉 New features

🐛 Bug fixes

💡 Others

14.1.5 — 2025-06-05

This version does not introduce any user-facing changes.

14.1.4 — 2025-04-30

This version does not introduce any user-facing changes.

14.1.3 — 2025-04-25

This version does not introduce any user-facing changes.

14.1.2 — 2025-04-14

This version does not introduce any user-facing changes.

14.1.1 — 2025-04-09

This version does not introduce any user-facing changes.

14.1.0 — 2025-04-04

💡 Others

  • [Android] Started using expo modules gradle plugin. (#34138 by @lukmccall)
  • [apple] Migrate remaining expo-module.config.json to unified platform syntax. (#34445 by @reichhartd)

14.0.3 - 2025-01-21

🐛 Bug fixes

  • [Android] Bump the Dimezis/BlurView dependency to the latest patch version. (#34012 by @jakobsen)

14.0.2 - 2025-01-10

This version does not introduce any user-facing changes.

14.0.1 — 2024-10-22

This version does not introduce any user-facing changes.

14.0.0 — 2024-10-22

🛠 Breaking changes

🐛 Bug fixes

  • Add missing react and react-native peer dependencies for isolated modules. (#30459 by @byCedric)

13.0.2 — 2024-05-01

This version does not introduce any user-facing changes.

13.0.1 — 2024-04-23

This version does not introduce any user-facing changes.

13.0.0 — 2024-04-18

🎉 New features

  • Mark React client components with "use client" directives. (#27300 by @EvanBacon)

🐛 Bug fixes

💡 Others

  • Removed deprecated backward compatible Gradle settings. (#28083 by @kudo)

12.9.2 - 2024-02-16

🎉 New features

12.9.1 - 2023-12-19

This version does not introduce any user-facing changes.

12.9.0 — 2023-11-14

🛠 Breaking changes

12.8.0 — 2023-10-17

🛠 Breaking changes

  • Dropped support for Android SDK 21 and 22. (#24201 by @behenate)
  • Made BlurView on Android an experimental feature, which can be enabled with experimentalBlurMethod prop. (#24709 by @behenate)

💡 Others

  • Ship untranspiled JSX to support custom handling of jsx and createElement. (#24889 by @EvanBacon)

12.7.0 — 2023-09-15

🎉 New features

  • Support more blur effects. On iOS, using UIBlurEffect.Style. On Android, find the closest available color reference. (#24392 by @alanjhughes)

12.6.0 — 2023-09-04

🎉 New features

  • Added support for React Native 0.73. (#24018 by @kudo)

12.5.0 — 2023-08-02

This version does not introduce any user-facing changes.

12.4.1 — 2023-06-23

This version does not introduce any user-facing changes.

12.4.0 — 2023-06-21

🛠 Breaking changes

12.3.2 — 2023-06-13

🐛 Bug fixes

12.3.1 — 2023-05-08

This version does not introduce any user-facing changes.

12.3.0 — 2023-04-17

🎉 New features

12.2.2 — 2023-02-14

🐛 Bug fixes

  • Add WebkitBackdropFilter to support react-native-web styling. (#21146 by @EvanBacon)

12.2.1 — 2023-02-09

This version does not introduce any user-facing changes.

12.2.0 — 2023-02-03

🐛 Bug fixes

  • Add -webkit-backdrop-filter to support blurring on Safari. (#21003 by @EvanBacon)

12.1.0 — 2022-12-30

🎉 New features

  • Migrated iOS codebase to Swift and the new Expo modules API. (#19786 by @tsapeta)

12.0.1 — 2022-11-02

This version does not introduce any user-facing changes.

12.0.0 — 2022-10-25

🛠 Breaking changes

  • Bumped iOS deployment target to 13.0 and deprecated support for iOS 12. (#18873 by @tsapeta)

11.2.0 — 2022-07-07

This version does not introduce any user-facing changes.

11.1.0 — 2022-04-18

🐛 Bug fixes

  • Fixed the component not rendering correctly when the border radius style is set. (#16671 by @tsapeta)

11.0.0 — 2021-12-03

🛠 Breaking changes

  • On iOS replaced non-working alpha-based blur mechanism with a new one basing on UIViewPropertyAnimator. (#14946 by @bbarthec)
  • Renamed BlurProps to BlurViewProps to align with React Native's types naming convention. (#14946 by @bbarthec)

🐛 Bug fixes

  • On iOS fixed intensity property not blurring text content properly. (#14946 by @bbarthec)

10.0.1 — 2021-10-01

This version does not introduce any user-facing changes.

10.0.0 — 2021-09-28

🛠 Breaking changes

🐛 Bug fixes

  • Web: Cap intensity value at 100, update the tint color values. (#14112 by @Simek)
  • Fix building errors from use_frameworks! in Podfile. (#14523 by @kudo)

💡 Others

  • Migrated from @unimodules/core to expo-modules-core. (#13757 by @tsapeta)

9.0.3 — 2021-03-30

This version does not introduce any user-facing changes.

9.0.2 — 2021-03-23

🐛 Bug fixes

  • Fix types - tint now a string union 'dark' | 'light' | 'default' rather than any string. (#12264 by @brentvatne)

9.0.1 — 2021-03-10

🐛 Bug fixes

  • Remove peerDependencies and unimodulePeerDependencies from Expo modules. (#11980 by @brentvatne)

9.0.0 — 2021-01-15

🛠 Breaking changes

8.2.2 — 2020-12-04

🐛 Bug fixes

  • Explicitly pass down only the expected props on iOS. (#10648 by @cruzach)

8.2.1 — 2020-11-17

This version does not introduce any user-facing changes.

8.2.0 — 2020-08-18

🎉 New features

8.1.2 — 2020-05-29

This version does not introduce any user-facing changes.

8.1.1 — 2020-05-27

This version does not introduce any user-facing changes.