expo/atlas
expo/atlas has 241 GitHub stars and 8 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-18 03:36 UTC. Last push 2026-10-14.
Measured star growth
- in 24h
- 0
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Visualize React Native bundles to understand and optimize your app.
Web & AppsREADME.md
OriginalExpo Atlas
Inspect your Metro bundle, on module level.
π How to use it
Atlas is built into Expo starting from SDK 51, and enabled when defining the environment variable EXPO_UNSTABLE_ATLAS=true.
You can use Atlas with two Expo commands:
$ expo startβ Start a local dev server, Atlas will listen to any change within your project.$ expo exportβ Export your app to Android, iOS, or web. Atlas will generate theatlas.jsonlfile.
Using $ expo start
When enabling Atlas with the local dev server, you can access Atlas on http://localhost:8081/_expo/atlas. This shows you all information from the bundle loaded during development.
$ EXPO_UNSTABLE_ATLAS=true npx expo start
[!TIP] Expo start runs in development mode by default. If you want to see a production bundle of your app, you can start the local dev server in production mode:
$ expo start --no-dev.
Using $ expo export
When enabling Atlas during exports, Expo generates the .expo/atlas.json file in your project. This file contains all bundle information, including the actual source code of individual files. You can open the Atlas file through npx expo-atlas [path/to/atlas.jsonl].
# Export the app for all platforms
$ EXPO_UNSTABLE_ATLAS=true npx expo export --platform all
# Open Atlas using the default `.expo/atlas.jsonl` path
$ npx expo-atlas
# Open Atlas from a shared file
$ npx expo-atlas ./path/to/atlas.jsonl
ποΈ Project structure
apps/exampleβ A default Expo project, with Atlas enabled by defaultpackages/expo-atlasβ The core package of Atlas, including Metro data handling and the CLI commandpackages/expo-atlas-uiβ The web-only Expo project representing the UI of Atlas
π§βπ» Contributing to Atlas
Atlas is open source and contributions are welcome.
ποΈ Preparing the repository
- Clone this repository
$ bun installβ Atlas uses Bun's package manager, ensure you have it installed
π¨ Changing the Atlas UI
If you need to change anything related to the Atlas UI, you need to:
$ bun startβ This builds expo-atlas and starts expo-atlas-ui with a default fixture$ open http://localhost:8081β To view expo-atlas-ui in your browser- Make any change in expo-atlas-ui
π Changing the Atlas data
If you need to change anything related to extracting data from Metro, you need to:
$ cd packages/expo-atlasβ Make the changes in expo-atlas$ bun startβ Build expo-atlas on any change- Open another terminal
$ cd apps/exampleβ Atlas has a default Expo project to experiment with$ bun startβ The example project automatically enables Atlas through apps/example/.env$ bun expo exportβ The example project can also export an .expo/atlas.jsonl file$ bun expo-atlasβ When exporting an .expo/atlas.jsonl file, you can open Atlas using this export
π¦ Releasing a new version
If you need to release a new version of Atlas, you need to:
- Make sure you have no uncomitted changes and have checked out main
- Update the package version in expo-atlas/package.json
- Commit the new version to main
$ bun installβ Make sure to install all dependencies$ bun run buildβ Build both expo-atlas and expo-atlas-ui$ cd packages/expo-atlas && npm publishβ Release a new version of Atlas
with β€οΈ Expo