Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 16 additions & 4 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,8 @@ versions follow [Semantic Versioning](https://semver.org/) with `alpha` prerelea

## [Unreleased]

## [0.1.0-alpha.7] - 2026-11-06

### Upgrading from 0.1.0-alpha.6
- The scaffolder is now revision 7, so every scaffold patch rn-xtool persisted in your `patches/` before this release
gets a warning at each `build`: "⚠ patches/<name> was written by an older rn-xtool scaffolder (revision 4, now 7);
Expand All @@ -18,6 +20,12 @@ versions follow [Semantic Versioning](https://semver.org/) with `alpha` prerelea
public header directories of its SwiftPM targets (`["OIDAuthState.h", "iOS/OIDAuthState+IOS.h", …]`), instead of
module names; a module name is refused with a message saying to list the headers. rn-xtool's AppAuth entry lists
the headers of AppAuth-iOS 3.0.0's umbrella header.
- A part of a scaffolded library's xcconfig value that only CocoaPods computes (in `OTHER_CFLAGS`,
`GCC_PREPROCESSOR_DEFINITIONS`, `HEADER_SEARCH_PATHS` or `SWIFT_ACTIVE_COMPILATION_CONDITIONS`) is still left out,
and `build` now names it in a `! <library>: Left out of …` line instead of dropping it silently:
react-native-worklets' and react-native-reanimated's static feature flags (all off, worklets'
`IOS_DYNAMIC_FRAMERATE_ENABLED` included) and react-native-vision-camera's frame processor and location switches
(off). See [troubleshooting.md](docs/troubleshooting.md#rctthirdpartycomponentsprovider-thirdpartyfabriccomponents).

### Fixed
- A bare app target with an Objective-C `main.m` (the React Native templates before 0.77) builds, instead of stopping
Expand Down Expand Up @@ -45,12 +53,15 @@ versions follow [Semantic Versioning](https://semver.org/) with `alpha` prerelea
crashed at start: the podspec reader evaluates Ruby locals, interpolation, `ENV` lookups, ternaries, `if`/`unless`
blocks, `push` on a local array, hashes and the library's `package.json`, and leaves out the branches a condition
rules out; a source glob, `compiler_flags`, `header_dir` or `frameworks` value it cannot evaluate stops that
library's scaffold with the podspec, the field and the expression, and an xcconfig flag it cannot evaluate is left
out with a warning that names it. react-native-worklets 0.8.3 keeps its `WORKLETS_VERSION` and
`REACT_NATIVE_MINOR_VERSION` defines.
library's scaffold with the podspec, the field and the expression (an xcconfig flag it cannot evaluate is left out,
see Changed). react-native-worklets 0.8.3 keeps its `WORKLETS_VERSION` and `REACT_NATIVE_MINOR_VERSION` defines.
- `build` and `install` stop, and remove the packed app, when a class React Native's codegen providers name is not in
the app, naming the class, its component or module and its library, instead of installing an app that would crash
at start in `+[RCTThirdPartyComponentsProvider thirdPartyFabricComponents]`.
- With these fixes, a production bare React Native 0.85.0 app with an Objective-C app target (`main.m`,
`AppDelegate.h` and `AppDelegate.mm` next to the project, a bridging header and a Swift file) and 20 native
libraries builds, installs over USB and launches on a physical iPhone (checked on 2026-11-06: the JS bundle loaded
from Metro and the app's own UI appeared; its features are not checked yet).

## [0.1.0-alpha.6] - 2026-11-05

Expand Down Expand Up @@ -536,7 +547,8 @@ First public release, as `react-native-xtool` (command `rn-xtool`).
- No Xcode tools on Linux: asset catalogs, storyboards and Metal shaders are skipped; library resource bundles and
vendored xcframeworks are not supported yet.

[Unreleased]: https://github.com/WillyAntunez/react-native-xtool/compare/v0.1.0-alpha.6...HEAD
[Unreleased]: https://github.com/WillyAntunez/react-native-xtool/compare/v0.1.0-alpha.7...HEAD
[0.1.0-alpha.7]: https://github.com/WillyAntunez/react-native-xtool/compare/v0.1.0-alpha.6...v0.1.0-alpha.7
[0.1.0-alpha.6]: https://github.com/WillyAntunez/react-native-xtool/compare/v0.1.0-alpha.5...v0.1.0-alpha.6
[0.1.0-alpha.5]: https://github.com/WillyAntunez/react-native-xtool/compare/v0.1.0-alpha.4...v0.1.0-alpha.5
[0.1.0-alpha.4]: https://github.com/WillyAntunez/react-native-xtool/compare/v0.1.0-alpha.3...v0.1.0-alpha.4
Expand Down
10 changes: 8 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,12 @@ SwiftPM pipeline.
[![npm](https://img.shields.io/npm/v/react-native-xtool/alpha?label=npm%20%40alpha)](https://www.npmjs.com/package/react-native-xtool)
[![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)

**Status:** alpha, [`react-native-xtool@0.1.0-alpha.6` on npm](https://www.npmjs.com/package/react-native-xtool) under the
**Status:** alpha, [`react-native-xtool@0.1.0-alpha.7` on npm](https://www.npmjs.com/package/react-native-xtool) under the
`alpha` tag. Verified end to end on a physical iPhone on 2026-11-04 and 2026-11-05: the first launch without Reload,
the dev client and the app icon; bare React Native 0.85; react-native-vision-camera, react-native-video,
react-native-device-info and @react-native-community/netinfo, with react-native-app-auth linked and an entitlements
file; and ML Kit text recognition with react-native-svg's Metal filters.
file; and ML Kit text recognition with react-native-svg's Metal filters. On 2026-11-06 a production bare React Native
0.85.0 app with an Objective-C app target and 20 native libraries built, installed and launched on a physical iPhone.

<!-- demo GIF: rn-xtool run → app opens on the iPhone → Fast Refresh -->
Demo video coming soon.
Expand Down Expand Up @@ -39,6 +40,11 @@ with one error naming these floors. Expo SDK 57 and 58 work the same way: newer
with a warning, older ones stop, and react-native stays exact (0.86.3 on SDK 57, 0.88.1 on SDK 58)
([details](docs/troubleshooting.md#newer-than-the-verified-versions)).

Apps that grew from older React Native templates build too: a production bare React Native 0.85.0 app with an
Objective-C app target (`main.m`, `AppDelegate.h` and `AppDelegate.mm` next to the project, a bridging header and a
Swift file) and 20 native libraries builds, installs over USB and launches on a physical iPhone (checked on
2026-11-06; its features are not checked yet, [details](docs/bare-react-native.md#react-native-085)).

`rn-xtool doctor --project` shows which line your project is on and what rn-xtool finds in it (the SwiftPM scripts
and prebuilt artifacts it would use, Expo's plugin and modules, podspec features), without the toolchain, login and
device checks ([details](docs/troubleshooting.md#doctor---project)).
Expand Down
22 changes: 17 additions & 5 deletions docs/bare-react-native.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,8 @@ artifacts, passed the precompiled framework check (G4) and produced `App.app`; t
[React Native 0.85](#react-native-085)). The same day, on a physical iPhone (iOS 26), that 0.85.0 app
(`@react-native-community/cli` 20.0.0, reanimated 4.3.4 and worklets 0.8.3) passed `build`, install over Wi‑Fi, the
first launch (tap Allow, and the app reloaded by itself), Hermes, reanimated animating and Fast Refresh. 0.85.3 has
not been run on a device.
not been run on a device. On 2026-11-06 a production 0.85.0 app with an Objective-C app target and 20 native libraries
built, installed over USB and launched on a physical iPhone (see [React Native 0.85](#react-native-085)).

On 0.86.3 the first build downloads about 1.3 GB of artifacts (about 3 minutes in our test; it depends on the
connection) and adapts them (about 2 s); later builds reuse the adapted slots (`rn-artifacts` 0.0 s). The library
Expand Down Expand Up @@ -166,8 +167,16 @@ build-verified only.
"Not among" warning; both name 0.85.3 as the version to move to, which is build-verified only.
- **Expo modules:** 0.85 with expo-modules-core is refused ("React Native 0.85.0 with Expo modules is not supported.
Expo SDK 58 needs React Native 0.88.1."), like 0.86 and 0.87.
- **What is proved:** the template app and the reanimated/worklets pair, on a device with 4.3.4 + 0.8.3 on 0.85.0.
Other libraries are untested on 0.85 (⏳ in [libraries.md](libraries.md)).
- **A production app:** on 2026-11-06 a bare React Native 0.85.0 app with an Objective-C app target (`main.m`,
`AppDelegate.h` and `AppDelegate.mm` next to the `.xcodeproj`, a bridging header and a Swift file) and 20 native
libraries, from react-native-screens 4.24.0, react-native-reanimated 4.3.0 with react-native-worklets 0.8.1 and
react-native-vision-camera 4.7 to @react-native-ml-kit/text-recognition and react-native-app-auth (the full list is in
[libraries.md](libraries.md)), was built (`rn-spm` about 10 minutes, `xtool-build` about 4.5 minutes), installed
over USB and launched on a physical iPhone (iOS 26): the JS bundle loaded from Metro and the app's own UI appeared.
Its feature checks (the camera, text recognition, the AppAuth login, Fast Refresh) are not done yet.
- **What is proved:** the template app and the reanimated/worklets pair, on a device with 4.3.4 + 0.8.3 on 0.85.0,
and the production app above, up to its launch. Other libraries are untested on 0.85 (⏳ in
[libraries.md](libraries.md)).

## Detection

Expand Down Expand Up @@ -238,7 +247,9 @@ the app's entry point from the App library, so a C-family `main` file is copied
Xcode. An app file already named `AppMain.<ext>` is an error, as two files with the same name are. A `main.swift` is
refused, by `build` and `doctor --project`, because Swift allows top-level code only in a file named `main.swift`: mark
the app delegate class `@main`, as the template's `AppDelegate.swift` does, move any other top-level code into it, and
remove `main.swift` from the app target.
remove `main.swift` from the app target. Verified on a physical iPhone on 2026-11-06 with a React Native 0.85.0 app
whose `main.m`, `AppDelegate.h` and `AppDelegate.mm` sit next to the `.xcodeproj`
([React Native 0.85](#react-native-085)).

## Mixed Swift + Objective-C/C++ app target

Expand All @@ -248,7 +259,8 @@ mechanism as the scaffolded mixed libraries (the two manifests described in
and your header search paths and defines are applied. The target's `.mm` and `.cpp` files compile with the project's
`CLANG_CXX_LANGUAGE_STANDARD` (C++20 when unset), passed to them as `-std=` because Swift Build does not apply the
package's `cxxLanguageStandard` to a mixed target. Verified on a device with an Objective-C module next to a Swift
module.
module, and on 2026-11-06 with the Objective-C app target of a production React Native 0.85.0 app, whose
`AppDelegate.mm` imports `<RCTAppDelegate.h>` and `<AppAuth/AppAuth.h>` ([React Native 0.85](#react-native-085)).

Swift Build names the generated Swift header `App-Swift.h` (the SwiftPM target is `App`), so `build` also writes
`Sources/App/include/<Module>-Swift.h`, which imports it: Objective-C keeps `#import "<Module>-Swift.h"` as in Xcode,
Expand Down
3 changes: 3 additions & 0 deletions docs/how-it-works.md
Original file line number Diff line number Diff line change
Expand Up @@ -593,6 +593,9 @@ identity, not from the team itself; on every device run so far it matched the Te
On a warm cache: patches 3.6 s, RN SwiftPM 11.1 s, ExpoModulesJSI 12.7 s, xtool build 24.5 s. The resulting `App.app`
is about 99 MB with 8 embedded frameworks.

A bare React Native 0.85.0 app with 20 native libraries, its scaffolds made again (2026-11-06): `rn-spm` 578 s,
`frameworks` 35 s, `xtool-build` 273 s.

## Further reading

- [recipe.md](recipe.md): the full technical recipe, with file locations.
Expand Down
Loading
Loading