expo-build-disk-cache [![npm][npm-image]][npm-url] ![npm][npm-dl-stats]

⚡ Drastically speed up your npx expo run:android or npx expo run:ios builds!

expo-build-disk-cache enables local disk caching for Expo builds.
When a cached build is available, it launches almost instantly — skipping the usual compilation step.

---

🚀 Quick Start

Requirements

• Expo SDK 53+

Installation

npm install --save-dev expo-build-disk-cache

Add to Your App Config

Expo SDK 54+

{
  "buildCacheProvider": {
    "plugin": "expo-build-disk-cache"
  }
}

Expo SDK 53

{
  "experiments": {
    "buildCacheProvider": {
      "plugin": "expo-build-disk-cache"
    }
  }
}

⚠️ Only expo run:android / expo run:ios use Expo's build cache provider. Builds run via expo prebuild + Gradle/Xcode/Fastlane/EAS are not cached (#24).

---

See the full Configuration Guide for advanced options, cache cleanup, CI setup, and remote caching.

---

📦 Releases

This repo uses Changesets.

1. For any user-facing package change, run bun run changeset and commit the generated file in .changeset/.
2. When changesets reach main, GitHub Actions opens or updates a release PR with the version bump and generated CHANGELOG.md.
3. Merge that release PR to publish to npm.

---

🤝 Acknowledgments

Huge thanks to the Expo team for making this possible and for their incredible open-source work.

---