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

14.0.9 — 2025-10-09

🐛 Bug fixes

• fix android image scaling in renderToImageAsync (#40113 by @vonovak)

14.0.8 — 2025-09-11

This version does not introduce any user-facing changes.

14.0.7 — 2025-09-02

This version does not introduce any user-facing changes.

14.0.6 — 2025-08-31

This version does not introduce any user-facing changes.

14.0.5 — 2025-08-27

🛠 Breaking changes

• [android] improve bitmap rendering for renderToImageAsync (#39118 by @vonovak)

14.0.4 — 2025-08-26

💡 Others

• Fix types and adjust platform checks. (#37302 by @EvanBacon)

14.0.3 — 2025-08-25

This version does not introduce any user-facing changes.

14.0.2 — 2025-08-16

This version does not introduce any user-facing changes.

14.0.1 — 2025-08-15

This version does not introduce any user-facing changes.

14.0.0 — 2025-08-13

🎉 New features

• expose ExpoFontLoader on web (#37991 by @vonovak)
• Add local package mocks. (#37736 by @aleqsio)

💡 Others

• [web] remove deprecated style 'type' attribute (#38114 by @vonovak)
• Add missing react-native peer dependency (#38540 by @kitten)
• Update remaining @expo/config-plugins in config plugin to expo/config-plugins (#38580 by @kitten)

13.3.2 - 2025-07-01

This version does not introduce any user-facing changes.

13.3.1 — 2025-05-02

🐛 Bug fixes

• Bail out early when getLoadedFonts returns an empty array. (#36586 by @brentvatne)

13.3.0 — 2025-04-30

🎉 New features

• [Android] Added support for font weight styles (through XML font definitions) to config plugin. (#26082 by @jongbelegen)

13.2.2 — 2025-04-25

This version does not introduce any user-facing changes.

13.2.1 — 2025-04-21

This version does not introduce any user-facing changes.

13.2.0 — 2025-04-21

🎉 New features

• Render to image (#36185 by @jakex7)

13.1.2 — 2025-04-14

This version does not introduce any user-facing changes.

13.1.1 — 2025-04-09

This version does not introduce any user-facing changes.

13.1.0 — 2025-04-04

🛠 Breaking changes

• Bump minimum macOS version to 11.0. (#34980 by @gabrieldonadel)

🎉 New features

• Support loading expo-font in a react-server environment. (#34736 by @EvanBacon)

🐛 Bug fixes

• Add missing export specifier. (#34839 by @EvanBacon)

💡 Others

• [Android] Started using expo modules gradle plugin. (#34176 by @lukmccall)

13.0.4 - 2025-02-19

This version does not introduce any user-facing changes.

13.0.3 - 2025-01-10

🐛 Bug fixes

• [ios] Fix crash when writing to fontFamilyAliases (#34044 by @techied)

13.0.2 - 2024-12-19

🐛 Bug fixes

• [iOS] Fix crash when accessing resource from multiple threads (#33574 by @chrfalch)

13.0.1 — 2024-11-05

💡 Others

• Remove deprecated Font.processFontFamily() (#32631 by @brentvatne)

13.0.0 — 2024-10-22

🛠 Breaking changes

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

🎉 New features

• More detailed error messages for FontLoader native module rejections (#31104 by @vonovak)
• Add getLoadedFonts() function (#30431 by @vonovak)

🐛 Bug fixes

• useFonts could previously attempt to set state on an unmounted component (#31143 by @vonovak)
• On iOS loadAsync() will reject if font loading fails. (#31053 by @vonovak)
• Add missing react peer dependencies for isolated modules. (#30467 by @byCedric)
• Only import from expo/config to follow proper dependency chains. (#30501 by @byCedric)

💡 Others

• Stopped scoping font family names in Expo Go on Android. (#28797 by @lukmccall)
• Replaced @testing-library/react-hooks with @testing-library/react-native. (#30742 by @byCedric)
• Removed all NativeModulesProxy occurrences. (#31496 by @reichhartd)

12.0.10 - 2024-09-03

🐛 Bug fixes

• Fix support for macOS. (#31307 by @gabrieldonadel)

12.0.9 - 2024-07-16

🐛 Bug fixes

• On iOS, fix issues where fonts were removed when the app is backgrounded. (#30400 by @alanjhughes)

12.0.8 - 2024-07-11

🎉 New features

• Allow woff and woff2 format on iOS with the config plugin. (#30220 by @titozzz)

12.0.7 - 2024-06-06

🐛 Bug fixes

• On iOS, store the font postscriptName instead of fullName which is what iOS will use to register the font. (#29502 by @alanjhughes)

12.0.6 - 2024-05-29

🐛 Bug fixes

• [iOS] Fix font registration failing when font was in use. (#28989 by @aleqsio)

12.0.5 — 2024-05-10

🐛 Bug fixes

• Fixed some vector icons not rendering correctly. (#28747 by @tsapeta)

12.0.4 — 2024-04-24

This version does not introduce any user-facing changes.

12.0.3 — 2024-04-24

• Fix font name lookup when name is not the same as family. (#28407 by @brentvatne)

12.0.2 — 2024-04-23

This version does not introduce any user-facing changes.

12.0.1 — 2024-04-22

💡 Others

• Stopped scoping font family names in Expo Go on iOS. (#28344 by @tsapeta)

12.0.0 — 2024-04-18

🎉 New features

• [iOS] The native module has been simplified and rewritten to Swift. (#26380 by @tsapeta)

💡 Others

• drop unused web name property. (#27437 by @EvanBacon)
• Remove most of Constants.appOwnership. (#26313 by @wschurman)
• Removed deprecated backward compatible Gradle settings. (#28083 by @kudo)

11.10.3 - 2024-02-16

🐛 Bug fixes

• Only include supported font files when using the plugin. (#27002 by @alanjhughes)

11.10.2 - 2024-01-18

This version does not introduce any user-facing changes.

11.10.1 - 2024-01-10

🎉 New features

• Added support for macOS platform. (#26242 by @tsapeta)

11.10.0 — 2023-12-12

🎉 New features

• Added custom native fonts support to Font.isLoaded(). (#25770 by @kudo)

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

🐛 Bug fixes

• Handle the case where no argument is passed to the plugin. (#25138 by @alanjhughes)

11.8.0 — 2023-10-17

🛠 Breaking changes

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

🎉 New features

• Added config plugin to allow fonts to be linked at build time. (#24772 by @alanjhughes)
• Remove unimodule.json in favour of expo-module.config.json. (#25099 by @reichhartd)

11.7.0 — 2023-09-15

🎉 New features

• Added support for Apple tvOS. (#24329 by @douglowder)

💡 Others

• Updated types for server functions. (#23911 by @EvanBacon)

11.6.0 — 2023-09-04

🎉 New features

• Added support for React Native 0.73. (#24018 by @kudo)
• Add static font extraction support with expo-router. (#24027 by @EvanBacon)

💡 Others

• Migrated FontLoaderModule to use Expo Modules API. (#24015 by @lukmccall)

11.5.1 — 2023-08-02

💡 Others

• Change unloaded font error to a warning. (#23788 by @EvanBacon)

11.5.0 — 2023-07-28

🐛 Bug fixes

• Gracefully catch exceptions during font loading on web with fontfaceobserver. (#22954 by @bradjones1)

11.4.0 — 2023-06-21

This version does not introduce any user-facing changes.

11.3.0 — 2023-06-13

🐛 Bug fixes

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

11.2.0 — 2023-05-08

🐛 Bug fixes

• Fix require cycle on web. (#21593 by @EvanBacon)

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.1 — 2022-10-28

This version does not introduce any user-facing changes.

11.0.0 — 2022-10-06

🛠 Breaking changes

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

🎉 New features

• Added support for Metro web. (#19234 by @EvanBacon)

10.2.0 — 2022-07-07

This version does not introduce any user-facing changes.

10.1.0 — 2022-04-18

⚠️ Notices

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

10.0.5 - 2022-02-01

🐛 Bug fixes

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

10.0.4 — 2021-11-17

This version does not introduce any user-facing changes.

10.0.1 — 2021-10-01

This version does not introduce any user-facing changes.

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

9.3.0 — 2021-09-08

💡 Others

• Rewrite android code to Kotlin (#13956 by @kkafar)

9.2.0 — 2021-06-16

🐛 Bug fixes

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

💡 Others

• Migrated unimodules-font-interface and unimodules-constants-interface to expo-modules-core. (#12949, #12876 by @tsapeta)
• Build Android code using Java 8 to fix Android instrumented test build error. (#12939 by @kudo)

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

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

9.0.0 — 2021-01-15

🛠 Breaking changes

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

🐛 Bug fixes

• Remove Expo.AppLoading reference in error. (#11204 by @brentvatne)
• Removed fbjs dependency (#11396 by @cruzach)

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.2 — 2020-07-27

🐛 Bug fixes

• Fixed fonts not being loaded in Internet Explorer. (#8652 by @d4rky-pl)

8.2.1 — 2020-05-29

This version does not introduce any user-facing changes.

8.2.0 — 2020-05-27

This version does not introduce any user-facing changes.

8.1.1 - 4/07/2020

🐛 Bug fixes

• Fixed timeout on Firefox #7420