Expo

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

Follow us on

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
• 🗺 Project Layout
• 🏅 Badges
• 👏 Contributing
• ❓ FAQ
• 💙 The Team
• License

📚 Documentation

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

• Getting Started
• API Reference
• Using Custom Native Modules

🗺 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](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.

Changelog

Unpublished

🛠 Breaking changes

🎉 New features

🐛 Bug fixes

💡 Others

15.0.7 — 2025-09-11

This version does not introduce any user-facing changes.

15.0.6 — 2025-09-02

💡 Others

• Change Constants to Constant/Property. (#38926 by @jakex7)

15.0.5 — 2025-08-31

This version does not introduce any user-facing changes.

15.0.4 — 2025-08-27

This version does not introduce any user-facing changes.

15.0.3 — 2025-08-25

This version does not introduce any user-facing changes.

15.0.2 — 2025-08-16

This version does not introduce any user-facing changes.

15.0.1 — 2025-08-15

This version does not introduce any user-facing changes.

15.0.0 — 2025-08-13

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

🐛 Bug fixes

• [Android] Fix throwing an error inside getOrientation when the currentActivity is not available. (#36369 by @alanjhughes)

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

🐛 Bug fixes

• Add missing getPermissionsAsync and requestPermissionsAsync implementations to native DeviceMotion modules. (#33719 by @ratley)

💡 Others

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

14.0.2 - 2025-01-10

This version does not introduce any user-facing changes.

14.0.1 — 2024-10-28

This version does not introduce any user-facing changes.

14.0.0 — 2024-10-22

🛠 Breaking changes

• Bumped iOS deployment target to 15.1. (#30840 by @tsapeta)

🐛 Bug fixes

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

💡 Others

• Fix incorrect event emitting tests. (#28953 by @aleqsio)
• Removed redundant usage of EventEmitter instance. (#28946 by @tsapeta)
• [Android] Remove usage of deprecated internal modules API. (#28715 by @lukmccall)
• [iOS] Fix pedometer sensor when app goes to background then foreground. ([#29957]https://github.com/expo/expo/pull/29957) by @rlods)

⚠️ Notices

• Added support for React Native 0.76.x. (#31552 by @gabrieldonadel)

13.0.9 - 2024-06-27

🎉 New features

• [iOS] Allow excluding motion permission APIs. (#29845 by @gabrieldonadel)

13.0.8 - 2024-05-29

🐛 Bug fixes

• [Android] Fixed NPE in DeviceMotionListener. (#29022 by @lukmccall)

13.0.7 — 2024-05-15

🐛 Bug fixes

• [Android] Fix crash when using DeviceMotion module. (#28839 by @behenate)

13.0.6 — 2024-05-13

💡 Others

• Add timestamps to relevant sensor events. (#28761 by @jkaufman)

13.0.5 — 2024-05-06

This version does not introduce any user-facing changes.

13.0.4 — 2024-05-01

This version does not introduce any user-facing changes.

13.0.3 — 2024-04-24

💡 Others

• Update mocks for SDK51. (#28424 by @aleqsio)

13.0.2 — 2024-04-23

This version does not introduce any user-facing changes.

13.0.1 — 2024-04-19

This version does not introduce any user-facing changes.

13.0.0 — 2024-04-18

🐛 Bug fixes

• Prevent unnecessary permissions check when moving app to background (Would crash with certain configs). (#28045 by @cltnschlosser)
• Fix barometer updates not starting on iOS 17.4. (#28253 by @alanjhughes)

💡 Others

• Prevent config plugin from writing permissions until prebuild. (#28107 by @EvanBacon)
• drop unused web name property. (#27437 by @EvanBacon)
• Fixed broken JavaScript unit tests. (#27257 by @kudo)
• Removed deprecated backward compatible Gradle settings. (#28083 by @kudo)
• Removed the usage of the legacy EventEmitter. (#28149 by @tsapeta)

12.9.1 - 2024-01-26

🐛 Bug fixes

• On Android, add event name to definition in the DeviceMotionModule. (#26679 by @alanjhughes)

12.9.0 — 2023-12-12

🐛 Bug fixes

• [Android] Fix pedometer not working due to lack of permissions. (#25815 by @omegascorp and @behenate)
• On iOS, fix an issue where permissions were requested on reload. (#25827 by @alanjhughes)

12.8.0 — 2023-11-14

🛠 Breaking changes

• Bumped iOS deployment target to 13.4. (#25063 by @gabrieldonadel)
• On Android bump compileSdkVersion and targetSdkVersion to 34. (#24708 by @alanjhughes)

12.7.0 — 2023-10-17

🛠 Breaking changes

• Dropped support for Android SDK 21 and 22. (#24201 by @behenate)

12.6.0 — 2023-09-15

💡 Others

• Migrated to Swift and Expo Modules API on iOS. (#24133 by @tsapeta)

12.5.0 — 2023-09-04

🎉 New features

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

🐛 Bug fixes

• Fix NullPointerException in PedometerModule. (#24079 by @jleprinc)

💡 Others

• Migrated Android codebase to use Expo modules API. (#23906 by @lukmccall)

12.4.1 — 2023-08-02

This version does not introduce any user-facing changes.

12.4.0 — 2023-07-28

💡 Others

• Use absolute motion reference frame to calculate device rotation if available on iOS. (#23738 by @jkaufman)

12.3.0 — 2023-06-21

🐛 Bug fixes

• Fixed Android build warnings for Gradle version 8. (#22537, #22609 by @kudo)

12.2.0 — 2023-05-08

This version does not introduce any user-facing changes.

12.1.1 — 2023-02-09

This version does not introduce any user-facing changes.

12.1.0 — 2023-02-03

🐛 Bug fixes

• Export types with type-only annotation to fix build when using isolatedModules flag. (#20239 by @zakharchenkoAndrii)

💡 Others

• On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)

12.0.1 — 2022-10-27

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)

🎉 New features

• Added support for the light sensor on Android. (#18225 by bearkillerPT)

💡 Others

• [plugin] Migrate import from @expo/config-plugins to expo/config-plugins and @expo/config-types to expo/config. (#18855 by @brentvatne)
• Drop @expo/config-plugins dependency in favor of peer dependency on expo. (#18595 by @EvanBacon)
• Export Expo Modules permissions related types. (#19525 by @Simek)
• DeviceMotion: Add DeviceMotionOrientation enum. (#19599 by @Simek)

11.4.0 — 2022-07-07

This version does not introduce any user-facing changes.

11.3.0 — 2022-04-27

⚠️ Notices

• Fixed exception on Android S+ devices for missing HIGH_SAMPLING_RATE_SENSORS permission. If the sensor update interval needs to be lower than 200ms, HIGH_SAMPLING_RATE_SENSORS should be explicitly added to AndroidManifest.xml. (#17177 by @kudo)

11.2.0 — 2022-04-18

💡 Others

• Updated @expo/config-plugins from 4.0.2 to 4.0.14 (#15621 by @EvanBacon)

⚠️ Notices

• On Android bump compileSdkVersion to 31, targetSdkVersion to 31 and Java version to 11. (#16941 by @bbarthec)

11.1.1 - 2022-02-01

🐛 Bug fixes

• Fix Plugin with id 'maven' not found build error from Android Gradle 7. (#16080 by @kudo)

11.1.0 — 2021-12-03

🐛 Bug fixes

• Fix Android crash caused by assertSubscriptionAlive method (#14720 by @zakharchenkoAndrii)

11.0.1 — 2021-10-01

This version does not introduce any user-facing changes.

11.0.0 — 2021-09-28

🛠 Breaking changes

• Dropped support for iOS 11.0 (#14383 by @cruzach)

🐛 Bug fixes

• Fix building errors from use_frameworks! in Podfile. (#14523 by @kudo)

💡 Others

• Converted Android code to Kotlin (#13738 by @ixf)
• Updated @expo/config-plugins (#14443 by @EvanBacon)

10.2.0 — 2021-06-16

🐛 Bug fixes

• Enable kotlin in all modules. (#12716 by @wschurman)

💡 Others

• Migrated module interfaces from unimodules-sensors-interface to expo-modules-core. (#12888 by @tsapeta)
• Build Android code using Java 8 to fix Android instrumented test build error. (#12939 by @kudo)
• Removed unnecessary dependency on unimodules-permissions-interface. (#12961 by @tsapeta)

10.1.2 — 2021-04-13

🎉 New features

• Added permissions-related methods getPermissionsAsync and requestPermissionsAsync what replaces deprecated Permissions.askAsync() and Permissions.getAsync(). (#12501 by @EvanBacon)

🐛 Bug fixes

• Replaced Pedometer.watchStepCount() return type (PedometerListener) with an unified Unimodules type - Subscription. (#12497 by @Simek)

10.1.1 — 2021-04-01

This version does not introduce any user-facing changes.

10.1.0 — 2021-03-10

🎉 New features

• Converted plugin to TypeScript. (#11715 by @EvanBacon)
• Updated Android build configuration to target Android 11 (added support for Android SDK 30). (#11647 by @bbarthec)

10.0.0 — 2021-01-15

⚠️ Notices

• The package is now shipped with prebuilt binaries on iOS. You can read more about it on expo.fyi/prebuilt-modules. (#11224 by @tsapeta)

🛠 Breaking changes

• Dropped support for iOS 10.0 (#11344 by @tsapeta)

🎉 New features

• Created config plugins (#11538 by @EvanBacon)

🐛 Bug fixes

• Removed fbjs dependency (#11396 by @cruzach)

9.2.0 — 2020-11-17

This version does not introduce any user-facing changes.

9.1.0 — 2020-08-11

🐛 Bug fixes

• Ensure browser globals DeviceMotionEvent and DeviceOrientationEvent exist before attempting to read from them. (#9236 by @evanbacon)
• Fixed bug with low Barometer resolution on iOS. (#9441 by @barthap)

9.0.1 — 2020-05-29

This version does not introduce any user-facing changes.

9.0.0 — 2020-05-27

🛠 Breaking changes

• DeviceMotion.addListener emits events with rotationRate in degrees instead of radians on all platforms. (#7876 by @evanbacon)
• DeviceMotion.addListener emits events with rotationRate in the form of alpha = x, beta = y, gamma = z on all platforms. (#7876 by @evanbacon)

🎉 New features

• DeviceMotion.addListener emits events with interval property. (#7876 by @evanbacon)

🐛 Bug fixes

• All sensors use more precise gravity 9.80665 instead of 9.8. (#7876 by @evanbacon)