v0.1.0-alpha.1

react-native-xtool 0.1.0-alpha.1 (alpha)

Build, sign and install Expo and bare React Native iOS dev builds from Linux, with no Mac, then develop with Metro and Fast Refresh over Wi-Fi.

npm i -g react-native-xtool@alpha
rn-xtool setup --xcode-xip ~/Downloads/Xcode_27.1.xip
rn-xtool auth login
rn-xtool run

What works

• Expo SDK 58 projects, bare React Native 0.88 projects, and bare projects with Expo modules (hybrid).
• Swift, Objective-C and C++ sources in the app target; CocoaPods-only libraries get a generated Package.swift.
• Installs over USB or Wi-Fi (no cable after a one-time pairing), smart rebuilds (rn-xtool run), Fast Refresh.
• Verified on a physical iPhone: Expo and bare templates, 11+ libraries (see docs/libraries.md), expo-dev-client, clean-machine run in Docker.

Known limits

• Expo SDK 57 and older, React Native 0.87 and older: not yet.
• No iOS simulator, no production builds (use EAS), Linux x86_64 only (WSL2 works; arm64 untested).
• No Xcode tools on Linux: asset catalogs, storyboards and Metal shaders are skipped; library resource bundles and vendored xcframeworks are not supported yet.
• Free Apple ID: 7-day signatures, 3 apps.

Tested with

xtool 1.23.0, Swift 6.4.1, Darwin SDK from Xcode 27.1, Expo 58.0.19, React Native 0.88.0, Node 20+/22.