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

7.1.4 — 2025-04-30

This version does not introduce any user-facing changes.

7.1.3 — 2025-04-25

This version does not introduce any user-facing changes.

7.1.2 — 2025-04-14

This version does not introduce any user-facing changes.

7.1.1 — 2025-04-09

This version does not introduce any user-facing changes.

7.1.0 — 2025-04-04

💡 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)
• [iOS] Fix warnings which will become errors in Swift 6. (#35288 by @behenate)

7.0.1 - 2025-01-10

This version does not introduce any user-facing changes.

7.0.0 — 2024-10-22

🛠 Breaking changes

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

🐛 Bug fixes

• [iOS] fix ClipboardPasteButton asking for paste permission (#30623 by @vonovak)
• Fixed issue when copying PNG images on Android. (#29629 by @weslley75)
• Add missing react/react-native peer dependencies for isolated modules. (#30463 by @byCedric)

💡 Others

• Removed redundant usage of EventEmitter instance. (#28946 by @tsapeta)
• Standardized Babel configuration to use expo-module-scripts. (#31915 by @reichhartd)

6.0.3 — 2024-05-01

This version does not introduce any user-facing changes.

6.0.2 — 2024-04-24

💡 Others

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

6.0.1 — 2024-04-23

This version does not introduce any user-facing changes.

6.0.0 — 2024-04-18

💡 Others

• drop unused web name property. (#27437 by @EvanBacon)
• Rename CornerStyle and DisplayMode types to include Type suffix in name. (#27190 by @simek)
• Removed deprecated backward compatible Gradle settings. (#28083 by @kudo)

5.0.1 - 2023-12-19

This version does not introduce any user-facing changes.

5.0.0 — 2023-12-12

🐛 Bug fixes

• [Android] Fix path traversal vulnerability in getFileForUri function. (#25549 by @behenate)

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

4.7.0 — 2023-10-17

🛠 Breaking changes

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

💡 Others

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

4.6.0 — 2023-09-15

This version does not introduce any user-facing changes.

4.5.0 — 2023-09-04

🎉 New features

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

4.4.0 — 2023-08-02

This version does not introduce any user-facing changes.

4.3.0 — 2023-06-21

📚 3rd party library updates

• Updated robolectric to 4.10. (#22395 by @josephyanks)

🎉 New features

• On iOS, added native ClipboardPasteButton view that uses UIPasteControl. (#22823 by @alanjhughes)

🐛 Bug fixes

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

4.2.0 — 2023-05-08

This version does not introduce any user-facing changes.

4.1.2 - 2023-03-03

🐛 Bug fixes

• Fixed crash in clipboard listener on Android SDK <26 (#21383 by @frw)

4.1.1 — 2023-02-09

This version does not introduce any user-facing changes.

4.1.0 — 2023-02-03

💡 Others

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

4.0.2 — 2022-12-30

🐛 Bug fixes

• Fixed the ImageFormat or the StringFormat not working in the release builds on Android. (#20155 by @lukmccall)

4.0.1 — 2022-10-30

🐛 Bug fixes

• Fixed clipboard listener is called twice on Android. (#19723 by @lukmccall)
• Fixed clipboard listener can crash the application during initialization on Android. (#19723 by @lukmccall)

4.0.0 — 2022-10-25

🛠 Breaking changes

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

3.1.0 — 2022-07-07

🐛 Bug fixes

• Fixed clipboard listener returning invalid contentTypes value for images on Android. (#17644 by @barthap)
• Fixed setStringAsync causing bouncing in Safari. (#18010 by @barthap)

💡 Others

• Migrated Expo modules definitions to the new naming convention. (#17193 by @tsapeta)
• Migrated Android module to use Sweet API coroutines. (#18036 by @barthap)

3.0.1 — 2022-04-20

🐛 Bug fixes

• Fixed setStringAsync crashing when setting HTML content on web. (#17115 by @barthap)

3.0.0 — 2022-04-18

🛠 Breaking changes

• The content property of the clipboard event listener is now deprecated and always returns empty string and logs a warning message to the console. Use getStringAsync() instead.

🎉 New features

• Native module on Android is now written in Kotlin using the new API. (#16269 by @barthap)
• Added support for setting and getting images (setImageAsync, hasImageAsync, getImageAsync). (#16391, #16413, #16481 by @barthap)
• On iOS added support for setting and getting URLs (setUrlAsync, hasUrlAsync, getUrlAsync). (#16391 by @graszka22, @barthap)
• Added new method hasStringAsync that checks whether clipboard has text content. (#16524 by @barthap)
• Added support for HTML content in getStringAsync and setStringAsync. (#16551, #16687 by @barthap)
• Added new property contentTypes to the clipboard event listener describing contents of the clipboard. (#16787 by @barthap)

⚠ Notices

• Deprecated setString. Use setStringAsync instead. (#16320 by @barthap)
• On Android bump compileSdkVersion to 31, targetSdkVersion to 31 and Java version to 11. (#16941 by @bbarthec)

2.1.1 - 2022-02-01

🐛 Bug fixes

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

2.1.0 — 2021-12-03

🎉 New features

• Native module on iOS is now written in Swift using Sweet API. (#14959 by @tsapeta)

2.0.1 — 2021-10-01

This version does not introduce any user-facing changes.

2.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

• Clean up Android code. (#13517 by @mstach60161)
• Migrated from @unimodules/core to expo-modules-core. (#13757 by @tsapeta)

1.1.0 — 2021-06-16

🎉 New features

• Added Clipboard event listener (#13050 by @cruzach)

🐛 Bug fixes

• Fixed getStringAsync causing crashes on Web when an exception is thrown. (#12494 by @robertherber)
• Fixed newlines not being copied on web. (#12951 by @cruzach)

1.0.2 — 2021-03-23

🐛 Bug fixes

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

1.0.1 — 2020-12-08

This version does not introduce any user-facing changes.

1.0.0 — 2020-12-07

🐛 Bug fixes

This version does not introduce any user-facing changes.