Skip to content

Sync with react.dev @ ae5e4807 - #291

Merged
nafistiham merged 105 commits into
mainfrom
sync-ae5e4807
Oct 27, 2026
Merged

nafistiham merged 105 commits into
mainfrom
sync-ae5e4807

Conversation

@react-translations-bot

Copy link
Copy Markdown
Collaborator

This PR was automatically generated.

Merge changes from react.dev at ae5e480

The following files have conflicts and may need new translations:

Please fix the conflicts by pushing new commits to this pull request, either by editing the files directly on GitHub or by checking out this branch.

DO NOT SQUASH MERGE THIS PULL REQUEST!

Doing so will "erase" the commits from main and cause them to show up as conflicts the next time we merge.

mattcarrollcode and others added 30 commits April 8, 2026 08:29
Imgur withdrew from the UK due to the Online Safety Act, breaking all
images in the docs for UK-based users. This replaces all 195 Imgur
image references across 18 documentation files with locally hosted
copies served from react.dev/images/docs/scientists/.

50 image files are added to cover all direct references and dynamic
size variants (s/m/b/l suffixes used by the getImageUrl helper).

Fixes #8110

Co-authored-by: Tadao <tadao@travisfixes.com>
… (#8364)

* fix(docs): Change 'a Action' to 'an Action' in useOptimistic.md

This fixes a grammar error where 'a Action' should be 'an Action' since
'Action' starts with a vowel sound.

Related to #6713 - Capitalize React concepts in docs

* docs: Update Vite React Compiler setup for @vitejs/plugin-react@6.0.0

- Add instructions for using reactCompilerPreset with @rolldown/plugin-babel
- Document that inline babel option was removed in version 6.0.0
- Keep backward compatibility note for older versions
- Remove outdated vite-plugin-babel reference

Fixes #8353
* Clean up and expand fragment ref docs

* Add cached intersection observer usage example

* Expand focus example to show search

* Small clean ups

* Add FragmentInstance operations reference list

* Add reference to scrollIntoView operation

* Migrate examples to sandpack
Bumps button contrast to match the treatment on reactnative.dev.

Dark mode:
- primary text: dark:text-secondary (#404756) -> dark:text-gray-90 (#23272F)
- secondary border: #404756 -> #4E5769 (matches RN's rgb(78,86,104))

Light mode:
- secondary border: #D9DBE3 -> #BCC1CD (matches RN's rgb(188,193,205))

gray-90 keeps a subtle cyan tint on the teal button, per review feedback
(gray-95 was too flat).
* Claude use docs attempt

* Human updates

* Address review feedback

* Address additional review feedback

* Split Pitfall and DeepDive, clarify recreation examples

* Reorder DeepDive: prose before correct example

* Add Reading a Promise from context section

* Address review feedback and align DeepDive with RSC docs style

* Drop inaccurate claim about blocking page rendering

* Address feedback

* Address feedback: clarify use() accepts Promise or context

* Apply suggestion from @rickhanlonii

* Update src/content/reference/react/use.md

Co-authored-by: Ricky <rickhanlonii@gmail.com>

* [use] Add Pitfall on refetching Promises from context in RSCs

---------

Co-authored-by: Aurora Scharff <aurora.sofie@gmail.com>
Co-authored-by: Aurora Scharff <66901228+aurorascharff@users.noreply.github.com>
* fix: update use.md pitfall to mention that bypassing use can corrupt React's internal state tracking

* Apply suggestion from @rickhanlonii

* Apply suggestion from @rickhanlonii

* Apply suggestion from @rickhanlonii

* Apply suggestion from @rickhanlonii

* Update use.md with caution on bypassing `use`

Add warning about bypassing `use` and its effects on React Suspense.

* Apply suggestion from @rickhanlonii

* Update guidance on using the `use` hook with Promises

Clarify usage of `use` hook regarding Promise handling.

* Clarify usage of `use` with Promises

---------

Co-authored-by: Ricky <rickhanlonii@gmail.com>
* Fix broken internal link in Component reference (anchor)

* chore: trigger CLA check
Co-authored-by: Daksh Dhami <hi@lucii.xyz>
Co-authored-by: Daksh Dhami <hi@lucii.xyz>
Co-authored-by: Sebastian Sebbie Silbermann <sebastian.silbermann@vercel.com>
Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
Co-authored-by: Sebastian "Sebbie" Silbermann <silbermann.sebastian@gmail.com>
…browser extension (#7726)

* Rewrite React Developer Tools section in tutorial-tic-tac-toe

CodeSandbox doesn't seem to support any platform React Developer Tools as is seen in tutorial.
This section is rewritten to use the browser extension directly on the preview.

* Fixed the preview URL to the codesandbox instance just before this section
* Clarify use vs await

* Refine based on feedback

* Address review comments
Co-authored-by: Tuna <tuna@MacBookPro.station>
…505)

* [Suspense] Add 'What activates a Suspense boundary' section

* [Suspense] Clarify image activation wording (review feedback)

* Define "suspense-enabled-framework"

* Update outdated framework-less data fetching note to reference use()

* fix: clarify Suspense boundary activation and fallback behavior

* Add code example

* update styling

* Cleanup caveat

* add link to blogpost

* Replace notes with link to suspense docs

* Tweak caveat

* Update caveat to clarify streaming behavior during server rendering

* Address feedback

* address feedback

* Clarify documentation on Suspense-enabled frameworks

* Update links and wording

* Improve example

* Clarify heading for Suspense-enabled frameworks section

* Restructure page

* Update to be docs compliant and clarify images

* Address review feedback

* Add more suspense examples

* Add more examples

* Clarify image loading behavior during <ViewTransition> updates in Suspense documentation

* Enhance Suspense documentation with additional details on font and image loading during <ViewTransition> updates

* Update

* Enhance Suspense documentation with examples of stylesheet loading behavior and vanilla DOM comparison

* agent review
* Polish Suspense activation examples

- Move Canary badges into section headings and render them icon-only
  in the table of contents
- Replace the image demo's text fallback with a profile skeleton
- Add a combined example coordinating data, a stylesheet, a font, and
  an image behind one boundary, with a plain DOM comparison
- Match skeleton dimensions to the revealed content

* Make the combined example's data delay consistent between runs
* Tune Suspense demo heights, data delay, and DOM comparison wording

* Make section openers stand alone and restore demo timing

* Shrink image demo portraits so both cards fit without layout shift

* Name the resources in the combined section opener

* State the ViewTransition condition in the combined section opener

* Align combined section opener with sibling sections

* Frame font and image waiting as Suspense behavior gated on ViewTransition

* Match the combined section opener to its sibling sections

* Document the experimental defer prop

* Reduce the combined example's data delay

* tweak
* Add dynamic OG images for docs pages

* Match OG card design to existing static images

* Generate OG images statically at build time

* Clean up orphaned lockfile entry

* Show section label on OG cards and guard pages without a card

* Center title and enlarge section label on OG cards
…Leadership Council, and refresh membership.

Co-authored-by: Sebastian "Sebbie" Silbermann <silbermann.sebastian@gmail.com>
* Resize long og image text

* address feedback
Please accept my changes for React Alicante and CityJS Athens
@github-actions

Copy link
Copy Markdown

Size changes

Details

📦 Next.js Bundle Analysis for react-dev

This analysis was generated by the Next.js Bundle Analysis action. 🤖

⚠️ Global Bundle Size Increased

Page Size (compressed)
global 116.62 KB (🟡 +8 B)
Details

The global bundle is the javascript bundle that loads alongside every page. It is in its own category because its impact is much higher - an increase to its size means that every page on your website loads slower, and a decrease means every page loads faster.

Any third party scripts you have added directly to your app using the <script> tag are not accounted for in this analysis

If you want further insight into what is behind the changes, give @next/bundle-analyzer a try!

Five Pages Changed Size

The following pages changed size from the code in this PR compared to its base branch:

Page Size (compressed) First Load
/404 131.93 KB (🟡 +632 B) 248.55 KB
/500 131.94 KB (🟡 +632 B) 248.56 KB
/[[...markdownPath]] 134.47 KB (🟡 +667 B) 251.08 KB
/errors 132.19 KB (🟡 +632 B) 248.8 KB
/errors/[errorCode] 132.16 KB (🟡 +632 B) 248.78 KB
Details

Only the gzipped size is provided here based on an expert tip.

First Load is the size of the global bundle plus the bundle for the individual page. If a user were to show up to your website and land on a given page, the first load size represents the amount of javascript that user would need to download. If next/link is used, subsequent page loads would only need to download that page's bundle (the number in the "Size" column), since the global bundle has already been downloaded.

Any third party scripts you have added directly to your app using the <script> tag are not accounted for in this analysis

Next to the size is how much the size has increased or decreased compared with the base branch of this PR. If this percentage has increased by 10% or more, there will be a red status indicator applied, indicating that special attention should be given to this.

@nafistiham nafistiham left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

LGTM

@nafistiham
nafistiham added this pull request to the merge queue Oct 27, 2026
Merged via the queue into main with commit 237589e Oct 27, 2026
6 checks passed
@nafistiham
nafistiham deleted the sync-ae5e4807 branch October 27, 2026 08:13

This branch was successfully deployed

1 active deployment
Preview — 918aafb4 Deployed Oct 26, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.