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
48485de
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
15 changes: 10 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,14 +12,19 @@ This repo contains the source code and documentation powering [it.reactjs.org](h
### 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 [it.react.dev repo](https://github.com/reactjs/it.react.dev) on your local machine

### Installation

<<<<<<< HEAD
1. `cd it.react.dev` to go into the project root
=======
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.
>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f
3. `yarn` to install the website's npm dependencies

### Running locally
Expand All @@ -44,8 +49,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 @@ -62,7 +67,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 @@ -111,7 +111,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 @@ -48,8 +48,13 @@ Quando abbiamo rilasciato React Hooks nel 2018, la documentazione sugli Hooks pr

**La nuova documentazione insegna React con gli Hooks fin dall'inizio.** La documentazione è divisa in due sezioni principali:

<<<<<<< HEAD
* **[Impara React](/learn)** è un corso autogestito che insegna React da zero.
* **[API Reference](/reference)** fornisce i dettagli e gli esempi d'uso per ogni API React.
=======
* **[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

Vediamo più da vicino cosa trovi in ciascuna sezione.

Expand Down Expand Up @@ -466,11 +471,19 @@ Abbiamo confermato con i vendor dei browser che questa rappresentazione è scien

Nell'[API Reference](/reference/react), ogni API React ha ora una pagina dedicata. Questo include tutti i tipi di API:

<<<<<<< HEAD
- Hooks integrati come [`useState`](/reference/react/useState).
- Componenti integrati come [`<Suspense>`](/reference/react/Suspense).
- Componenti browser integrati come [`<input>`](/reference/react-dom/components/input).
- API orientate ai framework come [`renderToPipeableStream`](/reference/react-dom/server/renderToReadableStream).
- Altre API React come [`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

Noterai che ogni pagina API è divisa in almeno due segmenti: *Reference* e *Usage*.

Expand Down Expand Up @@ -614,7 +627,11 @@ button { display: block; margin-top: 10px; }

</Recipes>

<<<<<<< HEAD
Alcune pagine API includono anche [Troubleshooting](/reference/react/useEffect#troubleshooting) (per problemi comuni) e [Alternatives](/reference/react-dom/findDOMNode#alternatives) (per API deprecate).
=======
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

Speriamo che questo approccio renda l'API reference utile non solo per cercare un argomento, ma per vedere tutte le cose diverse che puoi fare con una data API — e come si collega alle altre.

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 @@ -646,7 +646,11 @@ const ref = useRef<number>(null);
ref.current = 1;
```

<<<<<<< HEAD
`MutableRef` è ora deprecato in favore di un unico tipo `RefObject` che `useRef` restituirà sempre:
=======
`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 @@ -397,7 +397,11 @@ Per maggiori informazioni, consulta la documentazione delle [Directives](/refere

Le Server Actions possono essere create in Server Components e passate come props a Client Components, oppure possono essere importate e usate in Client Components.

<<<<<<< HEAD
Per approfondire, consulta la documentazione delle [React Server Actions](/reference/rsc/server-actions).
=======
For more, see the docs for [React Server Actions](/reference/rsc/server-functions).
>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f

## Miglioramenti in React 19 {/*improvements-in-react-19*/}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14273,7 +14273,11 @@ Purtroppo, alcuni hooks sono ancora difficili da pensare in termini di funzione

Abbiamo scoperto che spesso la confusione deriva dall'usare un Effetto quando non ne hai bisogno. La guida [You Might Not Need an Effect](/learn/you-might-not-need-an-effect) copre molti casi in cui gli Effetti non sono la soluzione giusta. Tuttavia, anche quando un Effetto è adatto a un problema, gli Effetti possono essere ancora più difficili da capire rispetto ai lifecycle dei componenti classe.

<<<<<<< HEAD
Crediamo che una delle ragioni della confusione sia che gli sviluppatori pensano agli Effetti dalla prospettiva del _componente_ (come un lifecycle), invece che dal punto di vista degli _Effetti_ (cosa fa l'Effetto).
=======
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

Diamo un'occhiata a un esempio [dalla documentazione](/learn/lifecycle-of-reactive-effects#thinking-from-the-effects-perspective):

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,11 @@ Divulgazioni aggiuntive possono essere frustranti, ma in genere sono segno di un

### Framework e bundler interessati {/*affected-frameworks-and-bundlers*/}

<<<<<<< HEAD
Alcuni framework e bundler React dipendevano, avevano peer dependency o includevano i pacchetti React vulnerabili. I seguenti framework e bundler React sono interessati: [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) e [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

Consulta [le istruzioni nel post precedente](/blog/2025/12/03/critical-security-vulnerability-in-react-server-components#update-instructions) per i passaggi di aggiornamento.

Expand Down
Loading
Loading