rn-iso

Isolated React Native / Expo dev environments, so several worktrees or coding agents can build the same app on one machine at the same time without fighting over ports and simulators.

This repository is a workspace. Everything published lives under packages/.

Package	What it is
rn-iso	The CLI and the environment broker. up creates an owned simulator/emulator and reserves a collision-free Metro port, then prints the facts your build needs. It never runs your build and never starts Metro.
@rn-iso/metro-cache	One Metro transform cache shared by every worktree, instead of Metro's per-project default that makes each new workspace re-transform the whole module graph.
@rn-iso/expo-build-cache	A local Expo build cache provider. When no native input changed, the Expo CLI installs a cached .app / .apk instead of compiling.

Read the rn-iso documentation -- the commands, the ownership model, worktrees, settings, and cache housekeeping all live there. Each cache package documents its own wiring in its own README.

npx rn-iso up ios --json     # an owned sim + a reserved Metro port, as JSON
npx rn-iso init              # set a repo up for parallel agents
npx rn-iso guide             # reference docs, generated by the installed binary

Working in this repo

npm install                       # one-time, from the workspace root
npm test                          # runs the rn-iso suite
cd packages/rn-iso && npm link    # put the dev CLI on your PATH

CLAUDE.md is the orientation for anyone (human or agent) changing the code. RELEASE.md is the publish workflow: all three packages carry the same version and go out together.

License

MIT