Registry / devops / eas-local-cache

eas-local-cache

JSON →
library1.0.3jsnpmunverified

A custom build cache provider for Expo CLI that stores build artifacts locally to reduce build times. Version 1.0.3 is the current stable release. It works by generating a fingerprint hash for each build configuration; subsequent builds with the same fingerprint reuse cached artifacts. Unlike cloud-based caches (EAS Build Cache), this plugin keeps all data on the developer's machine, suitable for offline or privacy-sensitive scenarios. Ships TypeScript types. No breaking changes reported yet.

devops
npm install eas-local-cache
github ↗package ↗homepage ↗
INSTALL
IMPORT
SIG · EAS-LOCAL-CACHE
E
eas-local-cache
devopsjavascriptv1.0.3
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

default
✓ import easLocalCache from 'eas-local-cache'
✗ const easLocalCache = require('eas-local-cache')
Library is ESM-only; CommonJS require() will fail.
config plugin
✓ In app.config.ts: { experiments: { typedRoutes: true, buildCacheProvider: { plugin: 'eas-local-cache' } } }
✗ Cannot import plugin directly; it's configured via Expo config.
The package is a custom build cache provider for Expo CLI; usage is declarative in app config.
clearCache
✓ Not exported; clear cache manually via 'rm -rf .expo/cache'
✗ Importing clearCache from 'eas-local-cache' will result in undefined.
No programmatic cache clearing API is provided in v1.0.3.

Installs EAS Local Cache and configures it in Expo's app.config.ts to enable local build caching.

// Install: npm install --save-dev eas-local-cache // In app.config.ts: export default { experiments: { typedRoutes: true, buildCacheProvider: { plugin: 'eas-local-cache', }, }, }; // No code import needed; Expo CLI automatically uses the plugin during builds. // To clear cache: rm -rf .expo/cache
Debug
Known issues
gotchaCache is not automatically cleared when build configuration changes; stale caches may cause incorrect builds.
fix
Manually delete .expo/cache directory when changing build settings.
affects: >=1.0.0
gotchaPlugin name in config must be exact string 'eas-local-cache' — typos cause silent fallback to default cache behavior.
fix
Verify the plugin string matches the package name exactly.
affects: >=1.0.0
deprecatedNo deprecations reported yet in current version.
affects: >=1.0.0
Errors
Common errors & fixes
Cannot find module 'eas-local-cache' or its corresponding type declarations.
Missing or incomplete installation; package not in devDependencies.
fix
Run 'npm install --save-dev eas-local-cache' and ensure node_modules is present.
Build cache not being used; builds are always full.
Cache directory .expo/cache missing or fingerprint mismatch, or plugin not correctly configured.
fix
Check app.config.ts for 'buildCacheProvider.plugin: "eas-local-cache"', and ensure .expo/cache exists with correct file permissions.
Error: EACCES: permission denied, mkdir '.expo/cache'
Insufficient file system permissions to create cache directory.
fix
Run build with proper user permissions or set NODE_OPTIONS=--no-warnings; also ensure project root is writable.
Upgrade
Version history
1.0.3latest on npm
Audit
Dependencies

No dependency data recorded yet.

Agent activity
5 hits · last 30 days
node
4
Resources
githubhttps://github.com/dennytosp/eas-local-cache ↗
packageeas-local-cache ↗
homepagehttps://github.com/dennytosp/eas-local-cache#readme ↗
eas-local-cache — npm install eas-local-cache · libregistry