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

6.2.0 — 2025-06-04

🎉 New features

• Added rawResponse to TokenResponse, allows reading fields that are not part of RFC 6749. (#20284 by @stefan-schweiger)

🐛 Bug fixes

• Allow preferEphemeralSession in promptAsync method. (#35489 by @TJTorola)

💡 Others

• Remove "Please" from warnings and errors (#36862 by @brentvatne)

6.1.5 — 2025-04-30

This version does not introduce any user-facing changes.

6.1.4 — 2025-04-25

This version does not introduce any user-facing changes.

6.1.3 — 2025-04-21

This version does not introduce any user-facing changes.

6.1.2 — 2025-04-14

🐛 Bug fixes

• Fix clientId not being asserted properly if it's undefined in providers/Facebook, like it is for providers/Google

6.1.1 — 2025-04-09

This version does not introduce any user-facing changes.

6.1.0 — 2025-04-04

This version does not introduce any user-facing changes.

6.0.3 - 2025-01-31

This version does not introduce any user-facing changes.

6.0.2 - 2025-01-10

This version does not introduce any user-facing changes.

6.0.1 - 2024-11-29

💡 Others

• Allow prompt parameter of AuthRequest to accept multiple values as an array (#32373 by @Nkzn)

6.0.0 — 2024-10-22

🐛 Bug fixes

• Add missing react/react-native peer dependencies. (#30573 by @byCedric)

💡 Others

• Add basic support for using in API routes. (#31480 by @EvanBacon)
• Use getRandomValues from expo-crypto (#22608 by @LinusU)
• Add a standard main package entry point (index.ts). (#28970 by @Simek)
• Prefer using type for describing the shape of objects. (#28970 by @Simek)
• Standardized Babel configuration to use expo-module-scripts. (#31915 by @reichhartd)

5.5.2 — 2024-05-02

🛠 Breaking changes

• Drop deprecated expoClientId field from auth proxy. (#28590 by @EvanBacon)

5.5.1 — 2024-04-23

This version does not introduce any user-facing changes.

5.5.0 — 2024-04-18

💡 Others

• Remove most of Constants.appOwnership. (#26313 by @wschurman)

5.4.0 — 2023-12-12

💡 Others

• Added dependency on expo-application as it's no longer a dependency of the expo package. (#25583 by @tsapeta)

5.3.0 — 2023-11-14

💡 Others

• Migrate to new standard URL support on native. (#24941 by @EvanBacon)

5.2.2 — 2023-10-17

This version does not introduce any user-facing changes.

5.2.1 — 2023-09-16

This version does not introduce any user-facing changes.

5.2.0 — 2023-09-04

🛠 Breaking changes

• Fix for breaking change in expo-constants to only support new manifests. (#24267 by @wschurman)

5.1.2 — 2023-09-04

This version does not introduce any user-facing changes.

5.1.1 — 2023-08-02

This version does not introduce any user-facing changes.

5.1.0 — 2023-07-28

This version does not introduce any user-facing changes.

5.0.2 — 2023-06-28

💡 Others

• Remove references to startAsync from js doc. (#23150 by @alanhughes)
• Remove unnecessary test. (#23154 by @alanhughes)

5.0.1 — 2023-06-24

This version does not introduce any user-facing changes.

5.0.0 — 2023-06-21

💡 Others

• Remove all auth proxy APIs. (#22834 by @alanhughes)

4.1.0 — 2023-05-08

💡 Others

• Added deprecation warning to promptAsync when the useProxy option is used. (#21367 by @gabrieldonadel)
• Warn on use of Constants.manifest. (#22247 by @wschurman)

4.0.3 - 2023-02-23

This version does not introduce any user-facing changes.

4.0.2 - 2023-02-21

💡 Others

• Deprecated useProxy option. (#21313 by @gabrieldonadel)
• Replaced references of makeRedirectUriAsync with makeRedirectUri. (#21314 by @gabrieldonadel)

4.0.1 — 2023-02-09

This version does not introduce any user-facing changes.

4.0.0 — 2023-02-03

💡 Others

• Removed usage of the deprecated expo-random package. (#21063 by @lukmccall)

3.7.2 — 2022-10-25

💡 Others

• Update docs to remove mentions of expo start:web. (#18419 by @EvanBacon)

3.7.1 — 2022-07-16

This version does not introduce any user-facing changes.

3.7.0 — 2022-07-07

🎉 New features

• Add projectNameForProxy option. (#17327 by @wschurman)

3.6.0 — 2022-04-18

💡 Others

• Export provider specific config types: FacebookAuthRequestConfig and GoogleAuthRequestConfig. (#16223 by @Simek)
• Add missing language field to the GoogleAuthRequestConfig. (#16223 by @Simek)

3.5.0 — 2021-12-03

This version does not introduce any user-facing changes.

3.4.1 — 2021-10-01

🐛 Bug fixes

• Fixed an import from deprecated @unimodules/react-native-adapter package. (#14585 by @tsapeta)

3.4.0 — 2021-09-28

🎉 New features

• Update JS code to read manifest2 when manifest is not available. (#13602 by @wschurman)

3.3.0 — 2021-06-16

🐛 Bug fixes

• Add new manifest2 field and make existing field optional. (#12817 by @wschurman)
• Use originalFullName instead of currentFullName (#12953) by @wschurman)

3.2.3 — 2021-04-13

This version does not introduce any user-facing changes.

3.2.2 — 2021-04-09

🎉 New features

• Add support for useProxy in bare workflow. (#12464 by @EvanBacon)

3.2.1 — 2021-03-30

This version does not introduce any user-facing changes.

3.2.0 — 2021-03-10

🎉 New features

• Use sync random method for PKCE. (#10298 by @EvanBacon)

🐛 Bug fixes

• Remove peerDependencies and unimodulePeerDependencies from Expo modules. (#11980 by @brentvatne)
• Fix dependencies to align with bundledNativeModules.json. (#12113 by @brentvatne)

3.1.0 — 2021-01-15

This version does not introduce any user-facing changes.

3.0.0 — 2020-12-09

🛠 Breaking changes

• Make expo-random a peer dependency. (#11280 by @brentvatne)

2.0.1 — 2020-11-17

🐛 Bug fixes

• Improved mechanism used to determine whether in bare or managed workflow. (#10993 by @esamelson)

2.0.0 — 2020-09-22

This version does not introduce any user-facing changes.

1.5.0 — 2020-08-26

🎉 New features

• Create built-in providers/google for easy Google auth. (#9361 by @EvanBacon)
• Create built-in providers/facebook for easy Facebook auth. (#9361 by @EvanBacon)

1.4.2 — 2020-08-18

This version does not introduce any user-facing changes.

1.4.1 — 2020-06-23

🎉 New features

• Remove assert in favor of invariant. (#8934 by @EvanBacon)

🐛 Bug fixes

• Added custom Platform.isDOMAvailable pending @unimodules/react-native-adapter update. (#8934 by @EvanBacon)

1.4.0 — 2020-06-23

🎉 New features

• Added missing peerDependencies. (#8821 by @EvanBacon)
• Remove fbjs dependency. (#8821 by @EvanBacon)
• Created ResponseType.IdToken for id_token responses. (#8719 by @EvanBacon)
• authorizationEndpoint and tokenEndpoint are now optional. (#8736 by @EvanBacon)
• Added exchange, refresh, and revoke token request methods. (#8051 by @EvanBacon)

1.3.1 — 2020-05-29

This version does not introduce any user-facing changes.

1.3.0 — 2020-05-27

🐛 Bug fixes

• Fix AuthSession.getDefaultReturnUrl() returning wrong URL while using release channels. (#7687 by @lukmccall)
• Fixed a bug where the useAutoDiscovery() hook hadn't finished before a component was unmounted. There was no cleanup, so when the fetch request completed, a react state update was attempted on an unmounted component. (#12491 by @andrew1601)