Expo

Try Expo in the Browser | Read the Documentation 📚

• 📚 Documentation
• 🗺 Project Layout
• 🏅 Badges
• 👏 Contributing
• ❓ FAQ
• 💙 The Team
• License

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 is where the Expo client software is developed, and includes the client apps, modules, apps, and more. The Expo CLI repository contains the Expo development tools.

Click here to view the Expo Community Guidelines. Thank you for helping keep the Expo community open and welcoming!

📚 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 the Unimodules, 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 Unimodules. You'll do most of your testing in here.
• docs The source code for https://docs.expo.io
• templates The template projects you get when you run expo start
• react-native-lab This is our fork of react-native. We keep this very close to the upstream but sometimes need to add quick fixes locally before they can land.
• guides In-depth tutorials for advanced topics like contributing to the client.
• android contains the Android project.
• home contains the JavaScript source code of the app.
• ios contains the iOS project.
• ios/Exponent.xcworkspace is the Xcode workspace. Always open this instead of Exponent.xcodeproj because the workspace also loads the CocoaPods dependencies.
• tools contains 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.io/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.io/client)

👏 Contributing

If you like Expo and want to help make it better then check out our contributing guide! Check out the Expo CLI repo to work on the Expo CLI, and various other universal development tools.

❓ 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 forums or on Twitter @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

0.14.10 — 2021-09-24

This version does not introduce any user-facing changes.

0.14.9 — 2021-09-24

This version does not introduce any user-facing changes.

0.14.8 — 2021-09-08

This version does not introduce any user-facing changes.

0.14.7 — 2021-09-07

This version does not introduce any user-facing changes.

0.14.6 — 2021-07-20

This version does not introduce any user-facing changes.

0.14.5 — 2021-07-09

This version does not introduce any user-facing changes.

0.14.4 — 2021-07-08

This version does not introduce any user-facing changes.

0.14.3 — 2021-06-24

This version does not introduce any user-facing changes.

0.14.2 — 2021-06-22

This version does not introduce any user-facing changes.

0.14.1 — 2021-06-16

This version does not introduce any user-facing changes.

0.14.0 — 2021-05-25

🐛 Bug fixes

• Remove expo-permissions (again). (#12900 by @brentvatne)

💡 Others

• Migrated interfaces from their own packages to expo-modules-core. (#12868, #12876, #12888, #12918, #12949 by @tsapeta)

0.13.3 — 2021-04-13

This version does not introduce any user-facing changes.

0.13.2 — 2021-04-09

🛠 Breaking changes

• Removed exported Permissions object and removed expo-permissions from dependencies. (#12405 by @bbarthec)

  expo-permissions is now deprecated — the functionality has been moved to other expo packages that directly use these permissions (e.g. expo-location, expo-camera).

🎉 New features

• Added tests field to options in use_unimodules ruby script. (#11972 by @esamelson)

0.13.1 — 2021-03-30

This version does not introduce any user-facing changes.

0.13.0 — 2021-03-10

🎉 New features

• Added support for statically configuring linking with react-native-unimodules object in the package.json. (#11524 by @EvanBacon)

0.12.0 — 2020-11-17

🐛 Bug fixes

• Fixed resolving Gradle module path when a symlink is provided. (#10007 by @barthap)

0.11.0 — 2020-08-18

🎉 New features

• Easier to follow installation instructions by moving them to the Expo documentation (#9145).

0.10.1 — 2020-05-29

📚 Library updates

• Updated dependencies to match versions included in Expo SDK38.

0.9.0

📚 Library updates

• Updated @unimodules/react-native-adapter to version 5.2.0.

0.8.1

🎉 New features

• Added unimodules-app-loader to dependencies.

0.8.0

🛠 Breaking changes

• Updated core packages, please refer to their changelogs to see the diff.
• Removed expo-app-loader-provider from dependencies.

🎉 New features

• Added expo-image-loader to dependencies.

🐛 Bug fixes

• Fix pod install --deployment failing due to pathname object being used instead of a string. (#96 by @tsapeta)

0.7.0

📚 Library updates

• Updated @unimodules/react-native-adapter to version 5.0.0.

🛠 Breaking changes

• Updated core packages, please refer to their changelogs to see the diff.

🎉 New features

• Allow passing custom pod flags to the unimodules.

0.6.0

🛠 Breaking changes

• Updated core packages, please refer to their changelogs to see the diff.

0.5.3

0.5.2

🐛 Bug fixes

• Updated @unimodules/core to version 3.0.2 including proper ProGuard rules.

0.5.0

🛠 Breaking changes

• Updated core packages, please refer to their changelogs to see the diff

0.4.2

🐛 Bug fixes

• Fixed MainApplication.kt not being recognized correctly. (#46 by @geovannimp)

0.4.1

🐛 Bug fixes

• Added support for Kotlin (#39 by @bbarthec)

0.4.0

🛠 Breaking changes

• Updated core packages, please refer to their changelogs to see the diff

🐛 Bug fixes

• Support version tags when adding dependencies for unimodules

0.3.1

🐛 Bug fixes

• Fixed TypeScript definitions of common unimodules not being exported. Thanks @saadq! (#24)
• Fixed automatic installation script not finding unimodules when using CocoaPods' --project-directory flag. (#31)

0.3.0

🎉 New features

• Automatically generated list of Android packages (#28) As of this version, you no longer need to add new packages to your MainApplication.java file. Just use new BasePackageList().getPackageList() instead 🎉. BasePackageList is auto-generated with a list of installed unimodules found in your node_modules folder during Gradle's Sync operation.