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

13.0.6 — 2025-01-10

This version does not introduce any user-facing changes.

13.0.5 — 2024-10-29

🎉 New features

• [Android] Added support for image refs in ImageManipulator.manipulate and useImageManipulator. (#32398 by @lukmccall)

13.0.4 — 2024-10-28

🎉 New features

• [iOS][Web] Added support for image refs in ImageManipulator.manipulate and useImageManipulator. (#32346, #32354 by @tsapeta)

13.0.3 — 2024-10-25

🎉 New features

• [iOS] Added support for image refs in ImageManipulator.manipulate and useImageManipulator. (#32346 by @tsapeta)

13.0.2 — 2024-10-24

💡 Others

• Exported missing types, removed unnecessary fallback and properly registered the module on Web. (#32302 by @tsapeta)

13.0.1 — 2024-10-22

This version does not introduce any user-facing changes.

13.0.0 — 2024-10-22

🛠 Breaking changes

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

🎉 New features

• [iOS][Web] Introduce a new API for image manipulation. (#30135, #30194 by @tsapeta)
• [Android] Introduce a new API for image manipulation. (#30232 by @lukmccall)

💡 Others

• Use the src folder as the Metro target. (#30079 by @tsapeta)
• Prefer UIGraphicsImageRenderer over UIGraphicsBeginImageContext. (#30211 by @alanjhughes)
• Provide image's memory footprint for better garbage collection. (#31168 by @tsapeta & #31784 by @lukmccall)

12.0.5 — 2024-05-13

This version does not introduce any user-facing changes.

12.0.4 — 2024-05-13

🐛 Bug fixes

• On iOS correctly handle urls coming from the users photo library. (#28777 by @alanjhughes)

12.0.3 — 2024-05-01

This version does not introduce any user-facing changes.

12.0.2 — 2024-04-23

This version does not introduce any user-facing changes.

12.0.1 — 2024-04-22

🎉 New features

• Added support for converting to WEBP on Android and iOS. (#26379 by @NikitaDudin)

12.0.0 — 2024-04-18

💡 Others

• drop unused web name property. (#27437 by @EvanBacon)
• Removed deprecated backward compatible Gradle settings. (#28083 by @kudo)

11.8.0 — 2023-12-12

🐛 Bug fixes

• [iOS] Fix an issue where the image is manipulated on a background thread. (#25756 by @alanjhughes)

💡 Others

• [iOS] Replace legacy FileSystem interfaces usage with core FileSystemUtilities. (#25495 by @alanhughes)

11.7.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)

🎉 New features

• Added extent action (#25116 by @LinusU)

11.6.0 — 2023-10-17

🛠 Breaking changes

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

11.5.0 — 2023-09-04

🎉 New features

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

11.4.1 — 2023-08-02

This version does not introduce any user-facing changes.

11.4.0 — 2023-07-28

This version does not introduce any user-facing changes.

11.3.0 — 2023-06-21

🐛 Bug fixes

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

11.2.0 — 2023-05-08

🐛 Bug fixes

• Handle images with an unsupported color space (#21757 by @mmmulani)

11.1.1 — 2023-02-09

This version does not introduce any user-facing changes.

11.1.0 — 2023-02-03

💡 Others

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

11.0.0 — 2022-10-25

🛠 Breaking changes

• Bumped iOS deployment target to 13.0 and deprecated support for iOS 12. (#18873 by @tsapeta)
• Migrated Android codebase to use the new Expo modules API. (#20683 by @alanhughes)

10.4.0 — 2022-07-07

💡 Others

• Migrated Expo modules definitions to the new naming convention. (#17193 by @tsapeta)

10.3.1 — 2022-04-20

🐛 Bug fixes

• Fix base64 result of manipulateAsync being always null on iOS. (#17122 by @barthap)

10.3.0 — 2022-04-18

🎉 New features

• Native module on iOS is now written in Swift using the new API. (#15277 by @tsapeta)

🐛 Bug fixes

• Remove data:image part in web base64 result. (#16191 by @AllanChain)
• On iOS fix rotation causing extra image borders. (#16669 by @mnightingale)

⚠️ Notices

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

10.2.1 - 2022-02-01

🐛 Bug fixes

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

10.2.0 — 2021-12-03

🐛 Bug fixes

• Fix Tainted canvases may not be exported CORS error on web. (#14739 by @IjzerenHein)

10.1.0 — 2021-10-01

🐛 Bug fixes

• Added missing dependency on expo-image-loader. (#14585 by @tsapeta)

10.0.0 — 2021-09-28

🛠 Breaking changes

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

🎉 New features

• Support loading base64 data URIs on iOS. (#13725 by @mnightingale)

🐛 Bug fixes

• Fix resize action validator to allow providing just one of width or height. (#13369 by @cruzach)
• Fix incorrect compression used when 0 is requested on web. (#13728 by @mnightingale)
• Fix Android manipulateAsync returns incorrect height (original unmanipulated height). (#13726 by @mnightingale)
• Fixed Android to use filename extension consistent with other platforms. (#13726 by @mnightingale)
• Fixed rotation direction to be clockwise on web. (#13760 by @mnightingale)
• Fixed web support for multiple actions. (#14056 by @mnightingale)
• Fix building errors from use_frameworks! in Podfile. (#14523 by @kudo)

💡 Others

• Migrated from @unimodules/core to expo-modules-core. (#13757 by @tsapeta)
• Refactored web to pass canvases to each action avoiding multiple calls to toDataURL. (#14145 by @mnightingale)

9.2.0 — 2021-06-16

🐛 Bug fixes

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

💡 Others

• Migrated from unimodules-file-system-interface to expo-modules-core.
• Build Android code using Java 8 to fix Android instrumented test build error. (#12939 by @kudo)
• Converted Android code to Kotlin. (#13231 by @dsokal)

9.1.0 — 2021-03-10

🎉 New features

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

🐛 Bug fixes

• Fixed incorrect image cropping on Web. (#12021 by @rSkogeby)

9.0.0 — 2021-01-15

🛠 Breaking changes

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

8.4.0 — 2020-11-17

This version does not introduce any user-facing changes.

8.3.0 — 2020-08-18

This version does not introduce any user-facing changes.

8.2.1 — 2020-05-29

This version does not introduce any user-facing changes.

8.2.0 — 2020-05-27

🛠 Breaking changes

• The base64 output will no longer contain newline and special character (\n, \r) on Android. (#7841 by @jarvisluong)