Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
53 commits
Select commit Hold shift + click to select a range
75ef18a
Add ViewTransition and addTransitionType to the reference indexes (#8…
BIGSUS24 Sep 29, 2026
8c68ae8
Use relative link, without domain, to Compiler docs (#8678)
smikitky Oct 1, 2026
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
e61aa4d
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`).
6 changes: 6 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,7 @@ React 문서 기여에 관심을 가져주셔서 감사합니다!

ES5만 다루는 경우라면 이 규칙은 무시하세요.

<<<<<<< HEAD
#### ES5의 기능만으로 간단하게 작성할 수 있는 경우, ES6의 기능을 무조건적으로 사용하지 마세요

ES6가 아직 낯선 사람도 많습니다. 이미 여러 곳에서 `const` / `let`, 클래스, 화살표 함수 등을 사용하고 있지만, 그에 상응하는 ES5 코드가 간단하고 가독성이 좋다면 ES5를 사용하는 것도 고려하세요.
Expand Down Expand Up @@ -71,6 +72,11 @@ class MyComponent extends React.Component {
```

실험적인 제안<sup>Experimental Proposal</sup>에 대해 설명하는 경우라면 예외로 하되, 코드와 주변 글에서 실험적임<sup>Experimental</sup>을 명시하세요.
=======
#### Prefer readable syntax.

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.
>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f

### 스타일

Expand Down
25 changes: 25 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,15 +22,28 @@
### 사전 준비

1. Git
<<<<<<< HEAD
1. Node: v16.8.0 이상의 모든 버전
1. Yarn v1(`yarn@1.22.22`): [Yarn 설치 안내](https://yarnpkg.com/lang/en/docs/install/) 참고
1. 포크<sup>Fork</sup>한 개인 저장소
1. 로컬에 클론<sup>Clone</sup>한 [ko.react.dev 저장소](https://github.com/reactjs/ko.react.dev)
=======
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
>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f

### 설치

<<<<<<< HEAD
1. `cd ko.react.dev`를 실행하여 프로젝트 경로로 이동합니다.
1. `yarn` 명령어를 실행하여 npm 의존성 모듈들을 설치합니다.
=======
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
>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f

### 개발 서버 실행하기

Expand All @@ -51,11 +64,19 @@

### 수정하기

<<<<<<< HEAD
1. ["개발 서버 실행하기"](#개발-서버-실행하기) 부분을 따릅니다.
1. 파일을 저장하고 브라우저에서 확인합니다.
1. `src` 안에 있는 React 컴포넌트가 수정될 경우 hot-reload가 적용됩니다.
1. `content` 안에 있는 마크다운 파일이 수정될 경우 hot-reload가 적용됩니다.
1. 플러그인을 사용하는 경우, `.cache` 디렉토리를 제거한 후 서버를 재시작해야 합니다.
=======
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 `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
>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f

### 수정사항 검사하기

Expand All @@ -72,7 +93,11 @@

## 문제 해결하기

<<<<<<< HEAD
`yarn cache-reset` 명령어를 사용하여 로컬 캐시를 초기화합니다.
=======
If you are interested in translating `react.dev`, please see the current translation efforts [here](https://react.dev/community/translations).
>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f

## 번역

Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -121,7 +121,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 @@ -42,8 +42,13 @@ description: 오늘 React와 React 문서의 새로운 보금자리인 react.dev

**새로운 문서는 Hook을 사용한 React를 처음부터 가르칩니다.** 문서는 두 가지 주요 섹션으로 나뉘어져 있습니다.

<<<<<<< HEAD
* **[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 @@ -460,13 +465,21 @@ export default function PackingList() {

[API 참고서](/reference/react)에서, 이제 모든 React API는 전용 페이지를 가집니다. 모든 종류의 API들이 포함됩니다.

<<<<<<< HEAD
- [`useState`](/reference/react/useState) 같은 내장 Hook
- [`<Suspense>`](/reference/react/Suspense) 같은 내장 컴포넌트
- [`<input>`](/reference/react-dom/components/input) 같은 브라우저 내장 컴포넌트
- [`renderToPipeableStream`](/reference/react-dom/server/renderToReadableStream) 같은 프레임워크 지향 API
- [`memo`](/reference/react/memo) 같은 그 밖의 React API
r
모든 API 페이지가 *레퍼런스* 와 *사용법*을 포함하는 최소 두 개의 세그먼트로 나뉘어 있다는 것을 알 수 있습니다.
=======
- 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

[레퍼런스](/reference/react/useState#reference)는 인자와 반환 값을 나열하여 형식적인 API 서명을 설명합니다. 이는 간결하지만, 해당 API에 익숙하지 않다면 약간 추상적으로 느껴질 수 있습니다. 이것은 API를 어떻게 사용하는지가 아닌, API가 무엇을 하는지를 설명합니다.

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

</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 서버 컴포넌트를 지원하기 위해, 특정 React 버전에 고정

서버 액션은 서버 컴포넌트에서 생성되며 클라이언트 컴포넌트에 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 @@ hooks를 출시했을 때, 저희는 세 가지 동기가 있었습니다:

종종 혼란은 필요하지 않을 때 Effect를 사용하는 데서 온다는 것을 발견했습니다. [You Might Not Need an Effect](/learn/you-might-not-need-an-effect) 가이드는 Effects가 올바른 솔루션이 아닌 경우들을 많이 다루고 있습니다. 하지만 Effect가 문제에 적합한 해결책일 때조차도, Effects는 클래스 컴포넌트 생명주기보다 여전히 이해하기 어려울 수 있습니다.

<<<<<<< HEAD
혼란의 이유 중 하나는 개발자들이 _Effects_ 관점(Effect가 무엇을 하는지)이 아니라 _컴포넌트의_ 관점(생명주기 같은)에서 Effects를 생각하기 때문이라고 생각합니다.
=======
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,7 @@ Additional disclosures can be frustrating, but they are generally a sign of a he

### Affected frameworks and bundlers {/*affected-frameworks-and-bundlers*/}

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), [@vite/rsc-plugin](https://www.npmjs.com/package/@vitejs/plugin-rsc), and [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).

Please see [the instructions in the previous post](/blog/2025/12/03/critical-security-vulnerability-in-react-server-components#update-instructions) for upgrade steps.

Expand Down
Loading
Loading