Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
51 commits
Select commit Hold shift + click to select a range
046f17d
Clarify image loading during View Transitions (#8671)
aurorascharff Oct 6, 2026
ae5e480
Add React DevTools for agents reference page (#8694)
hoxyq Oct 20, 2026
0821e7d
docs: document fetchPriority support for preloadModule and preinitMod…
coolwent Oct 27, 2026
0f7e4ec
Fix broken React Router links in "Synchronizing with Effects" and use…
romach Nov 3, 2026
97074a1
docs: add <form> to React DOM components overview (#8717)
YashCoder-svg Nov 3, 2026
0334d1d
Update conferences: move concluded Sep 2026 events to Past, fix React…
ShakilUrRehman21 Nov 3, 2026
7ca4886
Normalize aria-labels on TeamMember social links (#8592)
deepusnath Nov 3, 2026
6be2e2a
docs: Add useOptimistic hook description to hooks reference page (#8571)
martinrebo Nov 3, 2026
5532a01
Revert "docs: Add useOptimistic hook description to hooks reference p…
aurorascharff Nov 3, 2026
ae5c052
docs: add useOptimistic to Built-in React Hooks overview (#8625)
Iitian001 Nov 3, 2026
6b0a30d
Add missing 2026 conferences (#8730)
aurorascharff Nov 4, 2026
2177e28
Fix Server Function examples for Actions, forms, and useActionState (…
smith558 Nov 4, 2026
c1178e2
Update form documentation for forms default reset behavior (#8512)
MaxwellCohen Nov 5, 2026
dc8eb1e
Fix Server Function signature and two typos in 'use server' reference…
BlackHatMan Nov 5, 2026
879fe8c
Just fix some user-visible react.dev typos (only typos in this commit…
willy-b Nov 5, 2026
02acf3b
fix(docs): remove unncessary await from dispatchAction (#8674)
yousefdawood7 Nov 5, 2026
a003952
Link special HTML components to their React reference pages (#8596)
see-stack Nov 5, 2026
89e8328
Update conference listings for 2026 (#8218)
apherio Nov 5, 2026
c763eb2
Clarify that Transition Actions can be asynchronous (#8696)
yotatameguchi-boop Nov 5, 2026
00de546
Fix wrong link targets in react-dom docs (#8599)
see-stack Nov 5, 2026
391e70b
Use relative links, without domain, in reference docs (#8712)
ShakilUrRehman21 Nov 5, 2026
1f691ff
Fix API Reference link to point to /reference/react (#8603)
see-stack Nov 5, 2026
f9e9ed3
Fix broken and incorrect reference links (#8600)
see-stack Nov 5, 2026
b87d2bd
Fix redundant /index in static API links (#8602)
see-stack Nov 5, 2026
2e6dca1
docs: explain useFormStatus with custom form actions (#8683)
Felix-ming Nov 5, 2026
dd5e98c
Fix relative links missing leading slash in Learn docs (#8568)
MyGO-Mujica Nov 7, 2026
058f805
fix: consistent note object type in Server Components docs (#8475)
Ashutosh0x Nov 7, 2026
523831c
Fix effect event name on useEffectEvent reference docs (#8303)
Amulya-Kumar Nov 7, 2026
557ce1d
Fix duplicate words in reference docs (#8626)
eknathdj Nov 7, 2026
7159560
Fix onHeaders argument type in prerenderToNodeStream docs (#8720)
hsusul Nov 7, 2026
024c049
Fix typo, memorized -> memoized in learn typescript useMemo docs (#8312)
n34k Nov 7, 2026
313083d
fix: remove unused useState import in lifecycle-of-reactive-effects (…
jahanzaib-iqbal-dev Nov 7, 2026
79e6763
Fix typo in react-labs-view-transitions-activity-and-more.md (#8357)
acutmore Nov 7, 2026
d4b8243
docs: change MutableRef to MutableRefObject in React 19 upgrade guide…
mihkeleidast Nov 7, 2026
de83f1d
Fix incorrect name of @vitejs/plugin-rsc package (#8202)
ulrichstark Nov 7, 2026
b886228
Remove unused useState import in StrictMode.md (#8190)
emersonpisoni Nov 7, 2026
4acb201
docs: fix incorrect article usage (a/an) (#8393)
seojcarlos Nov 7, 2026
e0ec287
Explain that the useState setter triggers a re-render in Quick Start …
benjaminkincses Nov 7, 2026
fb39485
fix: typo in useReducer documentation (#7314)
aaqib605 Nov 7, 2026
6fba260
Fix act() event example using button before declaration (#8593)
fbellinder Nov 7, 2026
652b25c
docs: fix typo in useActionState and remove redundant async in useTra…
0verflowed-stack Nov 7, 2026
50bdc1e
Clarify ref callback cleanup behavior in common ref docs (#8579)
smg99 Nov 8, 2026
1fb9f91
Pass options to createConnection in useEffect (#8533)
SupunSPWithana Nov 8, 2026
4089cc0
docs: add missing "of" in render tree diagram alt text (#8420)
imxv Nov 8, 2026
d013b51
typo on prerender.md (#7467)
andihaki Nov 8, 2026
331f7e3
docs: fix terminology - 'argument' to 'parameter' in tutorial (#8376)
cyphercodes Nov 8, 2026
f5fa1e8
docs: update lifecycle-of-reactive-effects.md (#8232)
jaem0629 Nov 8, 2026
7594a2b
Correct outdated contributor documentation (#8734)
aurorascharff Nov 9, 2026
d935c7f
Add missing docs for requestFormReset API (#8576)
smg99 Nov 11, 2026
46a54e0
Link form reset guidance to requestFormReset reference (#8753)
aurorascharff Nov 11, 2026
f11eedb
merging all conflicts
react-translations-bot Nov 16, 2026
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
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,5 +3,5 @@ contact_links:
url: https://github.com/react/react/issues/new/choose
about: This issue tracker is not for bugs in React. Please file React issues here.
- name: 🤔 Questions and Help
url: https://reactjs.org/community/support.html
url: https://react.dev/community
about: This issue tracker is not for support questions. Please refer to the React community's help and discussion forums.
4 changes: 2 additions & 2 deletions .github/workflows/analyze.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,15 +18,15 @@ jobs:
- name: Set up node
uses: actions/setup-node@v4
with:
node-version: '20.x'
node-version: '24.x'
cache: yarn
cache-dependency-path: yarn.lock

- name: Restore cached node_modules
uses: actions/cache@v4
with:
path: '**/node_modules'
key: node_modules-${{ runner.arch }}-${{ runner.os }}-${{ hashFiles('yarn.lock') }}
key: node_modules-24-${{ runner.arch }}-${{ runner.os }}-${{ hashFiles('yarn.lock') }}

- name: Install deps
run: yarn install --frozen-lockfile
Expand Down
8 changes: 4 additions & 4 deletions .github/workflows/site_lint.yml
Original file line number Diff line number Diff line change
Expand Up @@ -13,22 +13,22 @@ jobs:
lint:
runs-on: ubuntu-latest

name: Lint on node 20.x and ubuntu-latest
name: Lint on node 24.x and ubuntu-latest

steps:
- uses: actions/checkout@v4
- name: Use Node.js 20.x
- name: Use Node.js 24.x
uses: actions/setup-node@v4
with:
node-version: 20.x
node-version: 24.x
cache: yarn
cache-dependency-path: yarn.lock

- name: Restore cached node_modules
uses: actions/cache@v4
with:
path: '**/node_modules'
key: node_modules-${{ runner.arch }}-${{ runner.os }}-${{ hashFiles('yarn.lock') }}
key: node_modules-24-${{ runner.arch }}-${{ runner.os }}-${{ hashFiles('yarn.lock') }}

- name: Install deps
run: yarn install --frozen-lockfile
Expand Down
4 changes: 2 additions & 2 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ This file provides guidance to Claude Code when working with this repository.

## Project Overview

This is the React documentation website (react.dev), built with Next.js 15.1.11 and React 19. Documentation is written in MDX format.
This is the React documentation website (react.dev), built with Next.js 15.1.12 and React 19. Documentation is written in MDX format.

## Development Commands

Expand Down Expand Up @@ -47,6 +47,6 @@ When editing files in `src/content/`, the appropriate skill will be auto-suggest
For MDX components (DeepDive, Pitfall, Note, etc.), invoke `/docs-components`.
For Sandpack code examples, invoke `/docs-sandpack`.

See `.claude/docs/react-docs-patterns.md` for comprehensive style guidelines.
See `.claude/skills/` for comprehensive style guidelines.

Prettier is used for formatting (config in `.prettierrc`).
36 changes: 2 additions & 34 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,41 +38,9 @@ Ignore this if you're specifically describing `createElement`.

Ignore this if you're specifically writing about ES5.

#### Don't use ES6 features when equivalent ES5 features have no downsides.
#### Prefer readable syntax.

Remember that ES6 is still new to a lot of people. While we use it in many places (`const` / `let`, classes, arrow functions), if the equivalent ES5 code is just as straightforward and readable, consider using it.

In particular, you should prefer named `function` declarations over `const myFunction = () => ...` arrows for top-level functions. However, you *should* use arrow functions where they provide a tangible improvement (such as preserving `this` context inside a component). Consider both sides of the tradeoff when deciding whether to use a new feature.

#### Don't use features that aren't standardized yet.

For example, **don't** write this:

```js
class MyComponent extends React.Component {
state = {value: ''};
handleChange = (e) => {
this.setState({value: e.target.value});
};
}
```

Instead, **do** write this:

```js
class MyComponent extends React.Component {
constructor(props) {
super(props);
this.handleChange = this.handleChange.bind(this);
this.state = {value: ''};
}
handleChange(e) {
this.setState({value: e.target.value});
}
}
```

Ignore this rule if you're specifically describing an experimental proposal. Make sure to mention its experimental nature in the code and in the surrounding text.
Choose syntax that makes each example easier to follow. Prefer named `function` declarations over `const myFunction = () => ...` arrows for top-level functions. Use arrow functions when they make callbacks easier to read. In class components, arrow functions can also preserve the component's `this` value.

### Style

Expand Down
11 changes: 6 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,14 +9,15 @@ This repo contains the source code and documentation powering [react.dev](https:
### Prerequisites

1. Git
1. Node: any version starting with v16.8.0 or greater
1. Yarn: See [Yarn website for installation instructions](https://yarnpkg.com/lang/en/docs/install/)
1. Node: v24 or greater
1. Yarn Classic: See [Yarn website for installation instructions](https://classic.yarnpkg.com/en/docs/install/)
1. A fork of the repo (for any contributions)
1. A clone of the [react.dev repo](https://github.com/reactjs/react.dev) on your local machine

### Installation

1. `cd react.dev` to go into the project root
2. `git remote add my-fork-name https://github.com/YOUR_USERNAME/react.dev.git` to add your fork as a remote. Replace `YOUR_USERNAME` with your GitHub username. You only need to do this once.
3. `yarn` to install the website's npm dependencies

### Running locally
Expand All @@ -41,8 +42,8 @@ The documentation is divided into several sections with a different tone and pur
1. Follow the ["Running locally"](#running-locally) instructions
1. Save the files and check in the browser
1. Changes to React components in `src` will hot-reload
1. Changes to markdown files in `content` will hot-reload
1. If working with plugins, you may need to remove the `.cache` directory and restart the server
1. Changes to markdown files in `src/content` will hot-reload
1. If working with plugins, you may need to remove the `node_modules/.cache/react-docs-mdx` directory and restart the server

### Test the change

Expand All @@ -59,7 +60,7 @@ The documentation is divided into several sections with a different tone and pur

## Translation

If you are interested in translating `react.dev`, please see the current translation efforts [here](https://github.com/reactjs/react.dev/issues/4135).
If you are interested in translating `react.dev`, please see the current translation efforts [here](https://react.dev/community/translations).

## License
Content submitted to [react.dev](https://react.dev/) is CC-BY-4.0 licensed, as found in the [LICENSE-DOCS.md](https://github.com/reactjs/react.dev/blob/main/LICENSE-DOCS.md) file.
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -113,7 +113,7 @@
"webpack-bundle-analyzer": "^4.5.0"
},
"engines": {
"node": ">=16.8.0"
"node": ">=24"
},
"nextBundleAnalysis": {
"budget": null,
Expand Down
16 changes: 8 additions & 8 deletions src/components/MDX/TeamMember.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ function GroupBadges({group}: {group: string}) {
);
}

// TODO: good alt text for images/links
// TODO: good alt text for images
export function TeamMember({
name,
title,
Expand Down Expand Up @@ -113,7 +113,7 @@ export function TeamMember({
aria-label={`${name} on Twitter`}
href={`https://twitter.com/${twitter}`}
className="hover:text-primary hover:underline dark:text-primary-dark flex flex-row items-center">
<IconTwitter className="pe-1" />
<IconTwitter className="pe-1" aria-hidden="true" />
{twitter}
</ExternalLink>
</div>
Expand All @@ -124,7 +124,7 @@ export function TeamMember({
aria-label={`${name} on Threads`}
href={`https://threads.net/${threads}`}
className="hover:text-primary hover:underline dark:text-primary-dark flex flex-row items-center">
<IconThreads className="pe-1" />
<IconThreads className="pe-1" aria-hidden="true" />
{threads}
</ExternalLink>
</div>
Expand All @@ -135,27 +135,27 @@ export function TeamMember({
aria-label={`${name} on Bluesky`}
href={`https://bsky.app/profile/${bsky}`}
className="hover:text-primary hover:underline dark:text-primary-dark flex flex-row items-center">
<IconBsky className="pe-1" />
<IconBsky className="pe-1" aria-hidden="true" />
{bsky}
</ExternalLink>
</div>
)}
{github && (
<div className="me-4">
<ExternalLink
aria-label="GitHub Profile"
aria-label={`${name} on GitHub`}
href={`https://github.com/${github}`}
className="hover:text-primary hover:underline dark:text-primary-dark flex flex-row items-center">
<IconGitHub className="pe-1" /> {github}
<IconGitHub className="pe-1" aria-hidden="true" /> {github}
</ExternalLink>
</div>
)}
{personal && (
<ExternalLink
aria-label="Personal Site"
aria-label={`${name}'s personal website`}
href={`https://${personal}`}
className="hover:text-primary hover:underline dark:text-primary-dark flex flex-row items-center">
<IconLink className="pe-1" /> {personal}
<IconLink className="pe-1" aria-hidden="true" /> {personal}
</ExternalLink>
)}
</div>
Expand Down
17 changes: 17 additions & 0 deletions src/content/blog/2023/03/16/introducing-react-dev.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,8 +41,13 @@

**新しいドキュメントでは、最初からフックを用いて React を学びます**。ドキュメントは主に 2 つのセクションに分かれています。

<<<<<<< HEAD

Check failure on line 44 in src/content/blog/2023/03/16/introducing-react-dev.md

View workflow job for this annotation

GitHub Actions / Lint on node 24.x and ubuntu-latest

コンフリクトマーカーが残っています。コンフリクトを解消してください。
* **[React を学ぶ](/learn)** は、ゼロから React を学ぶ自己学習型のコースです。
* **[API リファレンス](/reference)** では、すべての React API の詳細と使い方のサンプルが提供されています。
=======
* **[Learn React](/learn)** is a self-paced course that teaches React from scratch.
* **[API Reference](/reference/react)** provides the details and usage examples for every React API.
>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f

それぞれのセクションで見ることができる内容を詳しく見ていきましょう。

Expand Down Expand Up @@ -459,11 +464,19 @@

[API リファレンス](/reference/react) では、すべての React API に専用のページが用意されています。これにはあらゆる種類の API が含まれます:

<<<<<<< HEAD

Check failure on line 467 in src/content/blog/2023/03/16/introducing-react-dev.md

View workflow job for this annotation

GitHub Actions / Lint on node 24.x and ubuntu-latest

コンフリクトマーカーが残っています。コンフリクトを解消してください。
- 組み込みフックである [`useState`](/reference/react/useState) など。
- 組み込みコンポーネントである [`<Suspense>`](/reference/react/Suspense) など。
- 組み込みブラウザコンポーネントである [`<input>`](/reference/react-dom/components/input) など。
- フレームワーク向けの API である [`renderToPipeableStream`](/reference/react-dom/server/renderToReadableStream) など。
- その他の React API である [`memo`](/reference/react/memo) など。
=======
- Built-in Hooks like [`useState`](/reference/react/useState).
- Built-in components like [`<Suspense>`](/reference/react/Suspense).
- Built-in browser components like [`<input>`](/reference/react-dom/components/input).
- Framework-oriented APIs like [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream).
- Other React APIs like [`memo`](/reference/react/memo).
>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f

各 API ページは少なくとも*リファレンス*と*使用法*の 2 つのセグメントに分かれていることに気付くでしょう。

Expand Down Expand Up @@ -607,7 +620,11 @@

</Recipes>

<<<<<<< HEAD
一部の API ページには、(よくある問題に対する)[トラブルシューティング](/reference/react/useEffect#troubleshooting)や、(非推奨の API に対する)[代替手段](/reference/react-dom/findDOMNode#alternatives)のセクションも含まれています。
=======
Some API pages also include [Troubleshooting](/reference/react/useEffect#troubleshooting) (for common problems) and [Alternatives](https://18.react.dev/reference/react-dom/findDOMNode#alternatives) (for deprecated APIs).
>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f

このアプローチにより、API リファレンスが引数を調べる手段としてだけでなく、その API を使用してどれだけ色々なことができるのか、他の API とどのように繋がっているのかを示す手段として役立つことを願っています。

Expand Down
4 changes: 4 additions & 0 deletions src/content/blog/2024/04/25/react-19-upgrade-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -639,7 +639,11 @@ const ref = useRef<number>(null);
ref.current = 1;
```

<<<<<<< HEAD
`MutableRef` は廃止され、`useRef` は常に単一の `RefObject` 型を返すようになりました。
=======
`MutableRefObject` is now deprecated in favor of a single `RefObject` type which `useRef` will always return:
>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f

```ts
interface RefObject<T> {
Expand Down
4 changes: 4 additions & 0 deletions src/content/blog/2024/12/05/react-19.md
Original file line number Diff line number Diff line change
Expand Up @@ -389,7 +389,11 @@ React Server Components をバンドラやフレームワークでサポート

サーバアクションをサーバコンポーネント内で作成し props としてクライアントコンポーネントに渡すことも、クライアントコンポーネントでインポートして使用することもできます。

<<<<<<< HEAD
詳細については、[React サーバアクション](/reference/rsc/server-actions)のドキュメントをご覧ください。
=======
For more, see the docs for [React Server Actions](/reference/rsc/server-functions).
>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f

## React 19 の改善点 {/*improvements-in-react-19*/}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14266,7 +14266,11 @@ Activity の別のモードとして我々が考慮しているのは、メモ

多くの場合に混乱の原因は、必要もなくエフェクトが使われていることにあるとわかりました。[そのエフェクトは不要かも](/learn/you-might-not-need-an-effect)のガイドは、エフェクトがソリューションとして適切ではないパターンの多くをカバーしています。しかし、ある問題に対してエフェクトが適切であるという場合ですら、エフェクトはクラスコンポーネントのライフサイクルよりも理解しにくい場合があります。

<<<<<<< HEAD
混乱の一因は、開発者がエフェクトをエフェクト自体の視点(エフェクトが何をするか)ではなく、ライフサイクルのような*コンポーネント*の視点から考えてしまっていることにあると考えています。
=======
We believe one of the reasons for confusion is that developers tend to think of Effects from the _component's_ perspective (like a lifecycle), instead of the _Effects_ point of view (what the Effect does).
>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f

[ドキュメントにあるこちらの例](/learn/lifecycle-of-reactive-effects#thinking-from-the-effects-perspective)を見てみましょう。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,11 @@ _Updated January 26, 2026._

### 影響を受けるフレームワークとバンドラ {/*affected-frameworks-and-bundlers*/}

<<<<<<< HEAD
一部の React フレームワークやバンドラが、脆弱性のある React パッケージに依存しているか、peer dependency として依存しているか、あるいはそれらを含んでいました。影響を受ける React フレームワークやバンドラは以下の通りです:[next](https://www.npmjs.com/package/next)、[react-router](https://www.npmjs.com/package/react-router)、[waku](https://www.npmjs.com/package/waku)、[@parcel/rsc](https://www.npmjs.com/package/@parcel/rsc)、[@vite/rsc-plugin](https://www.npmjs.com/package/@vitejs/plugin-rsc)、[rwsdk](https://www.npmjs.com/package/rwsdk)
=======
Some React frameworks and bundlers depended on, had peer dependencies for, or included the vulnerable React packages. The following React frameworks & bundlers are affected: [next](https://www.npmjs.com/package/next), [react-router](https://www.npmjs.com/package/react-router), [waku](https://www.npmjs.com/package/waku), [@parcel/rsc](https://www.npmjs.com/package/@parcel/rsc), [@vitejs/plugin-rsc](https://www.npmjs.com/package/@vitejs/plugin-rsc), and [rwsdk](https://www.npmjs.com/package/rwsdk).
>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f

アップグレード方法について、[前回の記事の手順](/blog/2025/12/03/critical-security-vulnerability-in-react-server-components#update-instructions)を参照してください。

Expand Down
Loading
Loading