Skip to content

Docs: Mark React Native mobile editor as unmaintained on trunk after React 19 upgrade#78673

Merged
tyxla merged 1 commit into
trunkfrom
docs/react-native-unmaintained-after-react-19
May 26, 2026
Merged

Docs: Mark React Native mobile editor as unmaintained on trunk after React 19 upgrade#78673
tyxla merged 1 commit into
trunkfrom
docs/react-native-unmaintained-after-react-19

Conversation

@tyxla
Copy link
Copy Markdown
Member

@tyxla tyxla commented May 26, 2026

What?

Documents the React Native mobile editor's current status on trunk following the upgrade to React 19 (#61521) and points contributors at the right branching point for any fixes to the existing Gutenberg Mobile build.

Updated files:

  • docs/contributors/code/react-native/README.md — adds a Project status section as the canonical source for the current state.
  • docs/contributors/code/react-native/getting-started-react-native.md — adds a heads-up at the top, linking back to the project status section.
  • packages/react-native-editor/README.md, packages/react-native-bridge/README.md, packages/react-native-aztec/README.md — adds a short status callout in each package README.
  • CONTRIBUTING.md — replaces the "mirror .native.js changes" directive with a note that it's no longer required on trunk, and points RN fixes at the appropriate release tag.

Why?

From the React 19 tracking issue (#71336):

While breaking Gutenberg Mobile on trunk doesn't seem to be an ideal next step, it's a necessary one. The WP Mobile project is actively exploring paths forward for the block editor in the mobile apps, aiming to reduce complexity and improve alignment with the Gutenberg web project. There is currently little to no active work on the Gutenberg Mobile project. Therefore, to avoid encumbering the web project and its surrounding community, we must upgrade React and accept that doing so introduces technical debt for Gutenberg Mobile.

This PR addresses the still-unchecked task on that tracking issue:

  • Update documentation to make it clear that the RN implementation is paused and may be broken in trunk.

If a fix is needed against the existing Gutenberg Mobile build, the docs now direct contributors to branch from tag rnmobile/1.121.0 (commit e63b8b8, #63744) — the latest React Native release before the React 19 upgrade — and cut a minor release from there.

How?

Docs-only — no code or build changes. Each notice references PR #61521 and links back to the central Project status section so any entry point surfaces the same information.

Testing Instructions

Testing Instructions for Keyboard

N/A — docs only.

Screenshots or screencast

N/A — docs only.

…React 19 upgrade

The upgrade to React 19 (#61521) is incompatible with the current
Gutenberg Mobile setup and breaks the React Native build on `trunk`.
As noted on the tracking issue (#71336), this is a deliberate trade-off
while the WP Mobile project explores paths forward for the block editor.

Update the React Native docs and the relevant package READMEs to reflect
this state and point contributors at tag `rnmobile/1.121.0` (commit
`e63b8b8`, #63744) as the branching point for fixes to the existing
Gutenberg Mobile build.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 26, 2026

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: tyxla <tyxla@git.wordpress.org>
Co-authored-by: Mamaduka <mamaduka@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

@tyxla tyxla requested review from Mamaduka and jsnajdr May 26, 2026 09:50
@tyxla tyxla self-assigned this May 26, 2026
@tyxla tyxla added Framework Issues related to broader framework topics, especially as it relates to javascript [Type] Developer Documentation Documentation for developers Mobile App - i.e. Android or iOS Native mobile impl of the block editor. (Note: used in scripts, ping mobile folks to change) labels May 26, 2026
@tyxla tyxla mentioned this pull request May 26, 2026
23 tasks
Copy link
Copy Markdown
Member

@Mamaduka Mamaduka left a comment

Choose a reason for hiding this comment

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

Makes sense, thanks @tyxla!

Let's also ping @WordPress/native-mobile folks.

@tyxla tyxla enabled auto-merge (squash) May 26, 2026 10:15
@tyxla tyxla merged commit b94d9a3 into trunk May 26, 2026
59 of 66 checks passed
@tyxla tyxla deleted the docs/react-native-unmaintained-after-react-19 branch May 26, 2026 10:25
@github-actions github-actions Bot added this to the Gutenberg 23.3 milestone May 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Framework Issues related to broader framework topics, especially as it relates to javascript Mobile App - i.e. Android or iOS Native mobile impl of the block editor. (Note: used in scripts, ping mobile folks to change) [Type] Developer Documentation Documentation for developers

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants