Skip to content

docs: fix setup guidance found by the 1.0 build matrix - #1626

Open
msluszniak wants to merge 1 commit into
mainfrom
@ms/setup-docs-fixes
Open

msluszniak wants to merge 1 commit into
mainfrom
@ms/setup-docs-fixes

Conversation

@msluszniak

Copy link
Copy Markdown
Member

Description

  • pnpm: approve-builds ignores a package argument on pnpm 10; install with --allow-build=react-native-executorch (works on 10 and 12). bun skips the postinstall too: bun pm trust. Same in the podspec and Gradle errors.
  • Expo: babel-preset-expo adds the worklets plugin itself; the documented babel.config.js broke Metro under pnpm.
  • Troubleshooting: dynamic frameworks build since 0.11 (Firebase 27 needs them), iOS < 17 is a hard pod install error on the bare template, and a Podfile workaround for blob-util 0.25 on Xcode 27.

Introduces a breaking change?

  • Yes
  • No

Type of change

  • Bug fix (change which fixes an issue)
  • New feature (change which adds functionality)
  • Documentation update (improves or adds clarity to existing documentation)
  • Other (chores, tests, code style improvements etc.)

Tested on

  • iOS
  • Android

Testing instructions

Verified on the #1609 matrix (Xcode 27.2, S26 Ultra).

Screenshots

Related issues

Closes #1619, closes #1620, closes #1621, closes #1622
Refs #1617

Checklist

  • I have performed a self-review of my code
  • I have commented my code, particularly in hard-to-understand areas
  • I have updated the documentation accordingly
  • My changes generate no new warnings

Additional notes

- pnpm: approve-builds takes no package argument on pnpm 10; install with
  --allow-build instead. bun skips the postinstall too (bun pm trust).
- Expo: babel-preset-expo adds the worklets plugin itself, and the documented
  babel.config.js broke Metro under pnpm's isolated layout.
- Dynamic frameworks build since 0.11; Firebase 27 requires them.
- iOS < 17 fails pod install on the bare template, not only warns.
- Podfile workaround for react-native-blob-util 0.25 on Xcode 27.

Closes #1619, closes #1620, closes #1621, closes #1622
Refs #1617
@msluszniak msluszniak self-assigned this Nov 5, 2026
@msluszniak msluszniak added the bug fix PRs that are fixing bugs label Nov 5, 2026
@msluszniak
msluszniak requested a review from barhanc November 5, 2026 17:26
@@ -21,7 +21,9 @@ The native artifacts are not in the npm tarball. They are downloaded by a
**postinstall** hook, and your package manager skipped it:

- **pnpm 10 and later block dependency build scripts by default** and print

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

--allow-build was introduced in pnpm 10.4.0, so the new installation command doesn’t cover all versions described as “pnpm 10 and later.” Specify pnpm ≥10.4 or provide configuration plus rebuild instructions for earlier versions. pnpm documentation

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug fix PRs that are fixing bugs

Projects

None yet

2 participants