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

2.2.3 — 2025-04-30

This version does not introduce any user-facing changes.

2.2.2 — 2025-04-25

This version does not introduce any user-facing changes.

2.2.1 — 2025-04-14

🎉 New features

• Support imperative functions from SystemBars when edge-to-edge is enabled. (#36156 by @behenate)

2.2.0 — 2025-04-11

🎉 New features

• Use react-native-edge-to-edge system bars when edge-to-edge is enabled (#36087 by @brentvatne)

2.1.0 — 2025-04-04

• Warn about potential edge-to-edge interferences. (#34478 by @zoontek)

2.0.1 - 2025-01-10

This version does not introduce any user-facing changes.

2.0.0 — 2024-10-22

🐛 Bug fixes

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

💡 Others

• Minimize modules. (#31088 by @EvanBacon)

1.12.1 — 2024-04-23

This version does not introduce any user-facing changes.

1.12.0 — 2024-04-18

This version does not introduce any user-facing changes.

1.11.1 - 2023-12-19

This version does not introduce any user-facing changes.

1.11.0 — 2023-12-12

This version does not introduce any user-facing changes.

1.10.0 — 2023-11-14

🐛 Bug fixes

• Made the setStatusBarHidden methods animation parameter optional to match the documentation. (#23866 by @DoctorJohn)

1.9.0 — 2023-10-17

💡 Others

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

1.8.0 — 2023-09-15

💡 Others

• Reduce web bundle size. (#24297 by @EvanBacon)

1.7.1 — 2023-08-02

This version does not introduce any user-facing changes.

1.7.0 — 2023-07-28

🎉 New features

• Added support for animated property in setStatusBarStyle. (#23408 by @haikov)

1.6.0 — 2023-06-21

This version does not introduce any user-facing changes.

1.5.0 — 2023-05-08

This version does not introduce any user-facing changes.

1.4.4 — 2023-02-09

This version does not introduce any user-facing changes.

1.4.3 — 2023-02-03

💡 Others

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

1.4.2 — 2022-11-02

This version does not introduce any user-facing changes.

1.4.1 — 2022-10-25

This version does not introduce any user-facing changes.

1.4.0 — 2022-07-07

This version does not introduce any user-facing changes.

1.3.0 — 2022-04-18

This version does not introduce any user-facing changes.

1.2.0 — 2021-12-03

This version does not introduce any user-facing changes.

1.1.0 — 2021-09-09

This version does not introduce any user-facing changes.

1.0.4 — 2021-03-10

This version does not introduce any user-facing changes.

1.0.3 — 2020-11-17

This version does not introduce any user-facing changes.

1.0.2 — 2020-06-25

🐛 Bug fixes

• Provide web fallback for styleToBarStyle in order to not produce a warning.