diff --git a/.claude/agents/docs-reviewer.md b/.claude/agents/docs-reviewer.md
new file mode 100644
index 000000000..af0a856e4
--- /dev/null
+++ b/.claude/agents/docs-reviewer.md
@@ -0,0 +1,28 @@
+---
+name: docs-reviewer
+description: "Lean docs reviewer that dispatches reviews docs for a particular skill."
+model: opus
+color: cyan
+---
+
+You are a direct, critical, expert reviewer for React documentation.
+
+Your role is to use given skills to validate given doc pages for consistency, correctness, and adherence to established patterns.
+
+Complete this process:
+
+## Phase 1: Task Creation
+1. CRITICAL: Read the skill requested.
+2. Understand the skill's requirements.
+3. Create a task list to validate skills requirements.
+
+## Phase 2: Validate
+
+1. Read the docs files given.
+2. Review each file with the task list to verify.
+
+## Phase 3: Respond
+
+You must respond with a checklist of the issues you identified, and line number.
+
+DO NOT respond with passed validations, ONLY respond with the problems.
diff --git a/.claude/settings.json b/.claude/settings.json
new file mode 100644
index 000000000..111403183
--- /dev/null
+++ b/.claude/settings.json
@@ -0,0 +1,32 @@
+{
+ "skills": {
+ "suggest": [
+ {
+ "pattern": "src/content/learn/**/*.md",
+ "skill": "docs-writer-learn"
+ },
+ {
+ "pattern": "src/content/reference/**/*.md",
+ "skill": "docs-writer-reference"
+ }
+ ]
+ },
+ "permissions": {
+ "allow": [
+ "Skill(docs-voice)",
+ "Skill(docs-components)",
+ "Skill(docs-sandpack)",
+ "Skill(docs-rsc-sandpack)",
+ "Skill(docs-writer-learn)",
+ "Skill(docs-writer-reference)",
+ "Bash(yarn lint:*)",
+ "Bash(yarn lint-heading-ids:*)",
+ "Bash(yarn lint:fix:*)",
+ "Bash(yarn tsc:*)",
+ "Bash(yarn check-all:*)",
+ "Bash(yarn fix-headings:*)",
+ "Bash(yarn deadlinks:*)",
+ "Bash(yarn prettier:diff:*)"
+ ]
+ }
+}
diff --git a/.claude/skills/docs-components/SKILL.md b/.claude/skills/docs-components/SKILL.md
new file mode 100644
index 000000000..4b75f27a1
--- /dev/null
+++ b/.claude/skills/docs-components/SKILL.md
@@ -0,0 +1,518 @@
+---
+name: docs-components
+description: Comprehensive MDX component patterns (Note, Pitfall, DeepDive, Recipes, etc.) for all documentation types. Authoritative source for component usage, examples, and heading conventions.
+---
+
+# MDX Component Patterns
+
+## Quick Reference
+
+### Component Decision Tree
+
+| Need | Component |
+|------|-----------|
+| Helpful tip or terminology | `
Likes: {count}
+پیشنهاد میشود بهترتیب از لینکهای زیر شروع کنید:
حالا آدرس http://localhost:3000 را در
diff --git a/eslint-local-rules/__tests__/fixtures/src/content/missing-highlight.md b/eslint-local-rules/__tests__/fixtures/src/content/missing-highlight.md
new file mode 100644
index 000000000..f6dc1e734
--- /dev/null
+++ b/eslint-local-rules/__tests__/fixtures/src/content/missing-highlight.md
@@ -0,0 +1,3 @@
+```js [[1, 1, "submitAction"]]
+function UpdateName() {}
+```
diff --git a/eslint-local-rules/__tests__/fixtures/src/content/out-of-bounds-highlight.md b/eslint-local-rules/__tests__/fixtures/src/content/out-of-bounds-highlight.md
new file mode 100644
index 000000000..ac65974ad
--- /dev/null
+++ b/eslint-local-rules/__tests__/fixtures/src/content/out-of-bounds-highlight.md
@@ -0,0 +1,3 @@
+```js [[1, 3, "submitAction"]]
+function submitAction() {}
+```
diff --git a/eslint-local-rules/__tests__/fixtures/src/content/valid-highlight.md b/eslint-local-rules/__tests__/fixtures/src/content/valid-highlight.md
new file mode 100644
index 000000000..dd6074029
--- /dev/null
+++ b/eslint-local-rules/__tests__/fixtures/src/content/valid-highlight.md
@@ -0,0 +1,7 @@
+```js [[1, 1, "submitAction"]]
+function submitAction() {}
+```
+
+```js [[1, 1, "\\"hidden\\""]]
+const mode = "hidden";
+```
diff --git a/eslint-local-rules/__tests__/lint-markdown-code-blocks.test.js b/eslint-local-rules/__tests__/lint-markdown-code-blocks.test.js
index 250e0a1e5..c01f8cd02 100644
--- a/eslint-local-rules/__tests__/lint-markdown-code-blocks.test.js
+++ b/eslint-local-rules/__tests__/lint-markdown-code-blocks.test.js
@@ -123,6 +123,40 @@ async function run() {
),
'expected malformed metadata to be replaced with canonical form'
);
+<<<<<<< HEAD
+=======
+
+ const validHighlightResult = await lintFixture('valid-highlight.md');
+ assert.strictEqual(
+ validHighlightResult.messages.length,
+ 0,
+ 'expected a valid inline highlight to pass'
+ );
+
+ const missingHighlightResult = await lintFixture('missing-highlight.md');
+ assert.strictEqual(
+ missingHighlightResult.messages.length,
+ 1,
+ 'expected a highlight with text missing from its line to fail'
+ );
+ assert.strictEqual(
+ missingHighlightResult.messages[0].message,
+ "Could not find 'submitAction' on highlighted line 1"
+ );
+
+ const outOfBoundsHighlightResult = await lintFixture(
+ 'out-of-bounds-highlight.md'
+ );
+ assert.strictEqual(
+ outOfBoundsHighlightResult.messages.length,
+ 1,
+ 'expected an out-of-bounds highlight line to fail'
+ );
+ assert.strictEqual(
+ outOfBoundsHighlightResult.messages[0].message,
+ 'Code highlight line 3 is outside this code block'
+ );
+>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f
}
run().catch(error => {
diff --git a/eslint-local-rules/rules/inline-highlights.js b/eslint-local-rules/rules/inline-highlights.js
new file mode 100644
index 000000000..1e25fa6b9
--- /dev/null
+++ b/eslint-local-rules/rules/inline-highlights.js
@@ -0,0 +1,66 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+const INLINE_HIGHLIGHT_REGEX = /(\[\[.*\]\])/;
+
+function validateInlineHighlights(meta, code) {
+ const match = INLINE_HIGHLIGHT_REGEX.exec(meta);
+ if (!match) {
+ return [];
+ }
+
+ let highlights;
+ try {
+ highlights = JSON.parse(match[1]);
+ } catch (error) {
+ return ['Code highlight metadata must be valid JSON'];
+ }
+
+ if (!Array.isArray(highlights)) {
+ return ['Code highlight metadata must be an array'];
+ }
+
+ const lines = code.split('\n');
+ const errors = [];
+
+ for (const highlight of highlights) {
+ if (!Array.isArray(highlight) || highlight.length < 3) {
+ errors.push('Each code highlight must specify a step, line, and text');
+ continue;
+ }
+
+ const [, lineNo, text, fromIndex] = highlight;
+ if (!Number.isInteger(lineNo) || lineNo < 1 || lineNo > lines.length) {
+ errors.push(`Code highlight line ${lineNo} is outside this code block`);
+ continue;
+ }
+ if (typeof text !== 'string') {
+ errors.push(`Code highlight text on line ${lineNo} must be a string`);
+ continue;
+ }
+
+ const line = lines[lineNo - 1];
+ let index = line.indexOf(text);
+ const lastIndex = line.lastIndexOf(text);
+ if (index !== lastIndex) {
+ if (fromIndex === undefined) {
+ errors.push(
+ `Found '${text}' twice on highlighted line ${lineNo}; specify fromIndex`
+ );
+ continue;
+ }
+ index = line.indexOf(text, fromIndex);
+ }
+ if (index === -1) {
+ errors.push(`Could not find '${text}' on highlighted line ${lineNo}`);
+ }
+ }
+
+ return errors;
+}
+
+module.exports = {validateInlineHighlights};
diff --git a/eslint-local-rules/rules/lint-markdown-code-blocks.js b/eslint-local-rules/rules/lint-markdown-code-blocks.js
index 5ec327947..5d58868b9 100644
--- a/eslint-local-rules/rules/lint-markdown-code-blocks.js
+++ b/eslint-local-rules/rules/lint-markdown-code-blocks.js
@@ -16,6 +16,10 @@ const {
setCompilerExpectedLines,
} = require('./metadata');
const {normalizeDiagnostics} = require('./diagnostics');
+<<<<<<< HEAD
+=======
+const {validateInlineHighlights} = require('./inline-highlights');
+>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f
const {parseMarkdownFile} = require('./markdown');
const {runReactCompiler} = require('./react-compiler');
@@ -23,7 +27,11 @@ module.exports = {
meta: {
type: 'problem',
docs: {
+<<<<<<< HEAD
description: 'Run React Compiler on markdown code blocks',
+=======
+ description: 'Validate and compile markdown code blocks',
+>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f
category: 'Possible Errors',
},
fixable: 'code',
@@ -43,6 +51,20 @@ module.exports = {
const {blocks} = parseMarkdownFile(sourceCode.text, filename);
// For each supported code block, run the compiler and reconcile metadata.
for (const block of blocks) {
+<<<<<<< HEAD
+=======
+ for (const message of validateInlineHighlights(
+ block.meta,
+ block.code
+ )) {
+ context.report({
+ node,
+ loc: block.position,
+ message,
+ });
+ }
+
+>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f
const compilerResult = runReactCompiler(
block.code,
`${filename}#codeblock`
diff --git a/eslint-local-rules/rules/markdown.js b/eslint-local-rules/rules/markdown.js
index d888d1311..2de33c2c9 100644
--- a/eslint-local-rules/rules/markdown.js
+++ b/eslint-local-rules/rules/markdown.js
@@ -16,6 +16,10 @@ const {parseFenceMetadata} = require('./metadata');
* @property {{lineIndex: number, rawText: string, metaText: string, range: [number, number]}} fence
* @property {string} filePath
* @property {string} lang
+<<<<<<< HEAD
+=======
+ * @property {string} meta
+>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f
* @property {import('./metadata').FenceMetadata} metadata
*/
@@ -76,6 +80,10 @@ function parseMarkdownFile(content, filePath) {
blocks.push({
lang: rawLang || normalizedLang,
+<<<<<<< HEAD
+=======
+ meta: node.meta || metaText.trim(),
+>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f
metadata,
filePath,
code: node.value || '',
diff --git a/next.config.js b/next.config.js
index 5a5755307..c8d7bf0ed 100644
--- a/next.config.js
+++ b/next.config.js
@@ -19,6 +19,30 @@ const nextConfig = {
scrollRestoration: true,
reactCompiler: true,
},
+ async rewrites() {
+ return {
+ beforeFiles: [
+ // Explicit .md extension also serves markdown
+ {
+ source: '/:path*.md',
+ destination: '/api/md/:path*',
+ },
+ // Serve markdown when Accept header prefers text/markdown
+ // Useful for LLM agents - https://www.skeptrune.com/posts/use-the-accept-header-to-serve-markdown-instead-of-html-to-llms/
+ {
+ source: '/:path((?!llms\\.txt|api/md).*)',
+ has: [
+ {
+ type: 'header',
+ key: 'accept',
+ value: '(.*text/markdown.*)',
+ },
+ ],
+ destination: '/api/md/:path*',
+ },
+ ],
+ };
+ },
env: {},
webpack: (config, {dev, isServer, ...options}) => {
if (process.env.ANALYZE) {
@@ -36,6 +60,14 @@ const nextConfig = {
// Don't bundle the shim unnecessarily.
config.resolve.alias['use-sync-external-store/shim'] = 'react';
+ // ESLint depends on the CommonJS version of esquery,
+ // but Webpack loads the ESM version by default. This
+ // alias ensures the correct version is used.
+ //
+ // More info:
+ // https://github.com/reactjs/react.dev/pull/8115
+ config.resolve.alias['esquery'] = 'esquery/dist/esquery.min.js';
+
const {IgnorePlugin, NormalModuleReplacementPlugin} = require('webpack');
config.plugins.push(
new NormalModuleReplacementPlugin(
diff --git a/package.json b/package.json
index 4376cc18d..c35b7c43b 100644
--- a/package.json
+++ b/package.json
@@ -6,7 +6,12 @@
"scripts": {
"analyze": "ANALYZE=true next build",
"dev": "next-remote-watch ./src/content",
+<<<<<<< HEAD
"build": "next build && node --experimental-modules ./scripts/downloadFonts.mjs",
+=======
+ "prebuild:rsc": "node scripts/buildRscWorker.mjs",
+ "build": "node scripts/buildRscWorker.mjs && next build && node --experimental-modules ./scripts/downloadFonts.mjs && node ./scripts/generateOgImages.mjs",
+>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f
"lint": "next lint && eslint \"src/content/**/*.md\"",
"lint:fix": "next lint --fix && eslint \"src/content/**/*.md\" --fix",
"format:source": "prettier --config .prettierrc --write \"{plugins,src}/**/*.{js,ts,jsx,tsx,css}\"",
@@ -15,7 +20,11 @@
"prettier:diff": "yarn nit:source",
"lint-heading-ids": "node scripts/headingIdLinter.js",
"fix-headings": "node scripts/headingIdLinter.js --fix",
+<<<<<<< HEAD
"ci-check": "npm-run-all prettier:diff --parallel lint tsc lint-heading-ids rss deadlinks",
+=======
+ "ci-check": "npm-run-all prettier:diff --parallel lint test:eslint-local-rules tsc lint-heading-ids rss deadlinks",
+>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f
"tsc": "tsc --noEmit",
"start": "next start",
"postinstall": "yarn --cwd eslint-local-rules install && is-ci || husky install .husky",
@@ -35,9 +44,14 @@
"classnames": "^2.2.6",
"debounce": "^1.2.1",
"github-slugger": "^1.3.0",
+<<<<<<< HEAD
"next": "15.4.8",
+=======
+ "next": "15.1.12",
+>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f
"next-remote-watch": "^1.0.0",
"parse-numeric-range": "^1.2.0",
+ "raw-loader": "^4.0.2",
"react": "^19.0.0",
"react-collapsed": "4.0.4",
"react-dom": "^19.0.0",
@@ -49,6 +63,8 @@
"@babel/plugin-transform-modules-commonjs": "^7.18.6",
"@babel/preset-react": "^7.18.6",
"@mdx-js/mdx": "^2.1.3",
+ "@resvg/resvg-js": "^2.6.2",
+ "@shuding/opentype.js": "1.4.0-beta.0",
"@types/body-scroll-lock": "^2.6.1",
"@types/classnames": "^2.2.10",
"@types/debounce": "^1.2.1",
@@ -63,8 +79,14 @@
"asyncro": "^3.0.0",
"autoprefixer": "^10.4.2",
"babel-eslint": "10.x",
+<<<<<<< HEAD
"babel-plugin-react-compiler": "^19.1.0-rc.3",
"chalk": "4.1.2",
+=======
+ "babel-plugin-react-compiler": "^1.0.0",
+ "chalk": "4.1.2",
+ "esbuild": "^0.24.0",
+>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f
"eslint": "7.x",
"eslint-config-next": "12.0.3",
"eslint-config-react-app": "^5.2.1",
@@ -88,6 +110,7 @@
"postcss-flexbugs-fixes": "4.2.1",
"postcss-preset-env": "^6.7.0",
"prettier": "^2.5.1",
+ "react-server-dom-webpack": "^19.3.0",
"reading-time": "^1.2.0",
"remark": "^12.0.1",
"remark-external-links": "^7.0.0",
@@ -98,13 +121,14 @@
"retext": "^7.0.1",
"retext-smartypants": "^4.0.0",
"rss": "^1.2.2",
+ "satori": "^0.26.0",
"tailwindcss": "^3.4.1",
"typescript": "^5.7.2",
"unist-util-visit": "^2.0.3",
"webpack-bundle-analyzer": "^4.5.0"
},
"engines": {
- "node": ">=16.8.0"
+ "node": ">=24"
},
"nextBundleAnalysis": {
"budget": null,
diff --git a/plugins/remark-smartypants.js b/plugins/remark-smartypants.js
index f56f14b61..c819624ba 100644
--- a/plugins/remark-smartypants.js
+++ b/plugins/remark-smartypants.js
@@ -14,12 +14,24 @@ const visit = require('unist-util-visit');
const retext = require('retext');
const smartypants = require('retext-smartypants');
-function check(parent) {
+function check(node, parent) {
+ if (node.data?.skipSmartyPants) return false;
if (parent.tagName === 'script') return false;
if (parent.tagName === 'style') return false;
return true;
}
+function markSkip(node) {
+ if (!node) return;
+ node.data ??= {};
+ node.data.skipSmartyPants = true;
+ if (Array.isArray(node.children)) {
+ for (const child of node.children) {
+ markSkip(child);
+ }
+ }
+}
+
module.exports = function (options) {
const processor = retext().use(smartypants, {
...options,
@@ -43,8 +55,14 @@ module.exports = function (options) {
let startIndex = 0;
const textOrInlineCodeNodes = [];
+ visit(tree, 'mdxJsxFlowElement', (node) => {
+ if (['TerminalBlock'].includes(node.name)) {
+ markSkip(node); // Mark all children to skip smarty pants
+ }
+ });
+
visit(tree, ['text', 'inlineCode'], (node, _, parent) => {
- if (check(parent)) {
+ if (check(node, parent)) {
if (node.type === 'text') allText += node.value;
// for the case when inlineCode contains just one part of quote: `foo'bar`
else allText += 'A'.repeat(node.value.length);
diff --git a/public/fonts/Optimistic_Display_W_Bd.ttf b/public/fonts/Optimistic_Display_W_Bd.ttf
new file mode 100644
index 000000000..9d0cff450
Binary files /dev/null and b/public/fonts/Optimistic_Display_W_Bd.ttf differ
diff --git a/public/fonts/Optimistic_Display_W_Md.ttf b/public/fonts/Optimistic_Display_W_Md.ttf
new file mode 100644
index 000000000..3fbdb483d
Binary files /dev/null and b/public/fonts/Optimistic_Display_W_Md.ttf differ
diff --git a/public/images/blog/react-foundation/react_foundation_logo.png b/public/images/blog/react-foundation/react_foundation_logo.png
new file mode 100644
index 000000000..51c19598f
Binary files /dev/null and b/public/images/blog/react-foundation/react_foundation_logo.png differ
diff --git a/public/images/blog/react-foundation/react_foundation_logo.webp b/public/images/blog/react-foundation/react_foundation_logo.webp
new file mode 100644
index 000000000..89efa6027
Binary files /dev/null and b/public/images/blog/react-foundation/react_foundation_logo.webp differ
diff --git a/public/images/blog/react-foundation/react_foundation_logo_dark.png b/public/images/blog/react-foundation/react_foundation_logo_dark.png
new file mode 100644
index 000000000..4aedaf464
Binary files /dev/null and b/public/images/blog/react-foundation/react_foundation_logo_dark.png differ
diff --git a/public/images/blog/react-foundation/react_foundation_logo_dark.webp b/public/images/blog/react-foundation/react_foundation_logo_dark.webp
new file mode 100644
index 000000000..09b48b70d
Binary files /dev/null and b/public/images/blog/react-foundation/react_foundation_logo_dark.webp differ
diff --git a/public/images/blog/react-foundation/react_foundation_member_logos.png b/public/images/blog/react-foundation/react_foundation_member_logos.png
new file mode 100644
index 000000000..e83659693
Binary files /dev/null and b/public/images/blog/react-foundation/react_foundation_member_logos.png differ
diff --git a/public/images/blog/react-foundation/react_foundation_member_logos.webp b/public/images/blog/react-foundation/react_foundation_member_logos.webp
new file mode 100644
index 000000000..babb3d57c
Binary files /dev/null and b/public/images/blog/react-foundation/react_foundation_member_logos.webp differ
diff --git a/public/images/blog/react-foundation/react_foundation_member_logos_dark.png b/public/images/blog/react-foundation/react_foundation_member_logos_dark.png
new file mode 100644
index 000000000..116e40337
Binary files /dev/null and b/public/images/blog/react-foundation/react_foundation_member_logos_dark.png differ
diff --git a/public/images/blog/react-foundation/react_foundation_member_logos_dark.webp b/public/images/blog/react-foundation/react_foundation_member_logos_dark.webp
new file mode 100644
index 000000000..5fcf38ca9
Binary files /dev/null and b/public/images/blog/react-foundation/react_foundation_member_logos_dark.webp differ
diff --git a/public/images/blog/react-foundation/react_foundation_member_logos_dark_updated.png b/public/images/blog/react-foundation/react_foundation_member_logos_dark_updated.png
new file mode 100644
index 000000000..f969cadc8
Binary files /dev/null and b/public/images/blog/react-foundation/react_foundation_member_logos_dark_updated.png differ
diff --git a/public/images/blog/react-foundation/react_foundation_member_logos_dark_updated.webp b/public/images/blog/react-foundation/react_foundation_member_logos_dark_updated.webp
new file mode 100644
index 000000000..a6aa358f3
Binary files /dev/null and b/public/images/blog/react-foundation/react_foundation_member_logos_dark_updated.webp differ
diff --git a/public/images/blog/react-foundation/react_foundation_member_logos_updated.png b/public/images/blog/react-foundation/react_foundation_member_logos_updated.png
new file mode 100644
index 000000000..ca30ca6f4
Binary files /dev/null and b/public/images/blog/react-foundation/react_foundation_member_logos_updated.png differ
diff --git a/public/images/blog/react-foundation/react_foundation_member_logos_updated.webp b/public/images/blog/react-foundation/react_foundation_member_logos_updated.webp
new file mode 100644
index 000000000..4df97d799
Binary files /dev/null and b/public/images/blog/react-foundation/react_foundation_member_logos_updated.webp differ
diff --git a/public/images/docs/diagrams/19_2_batching_after.dark.png b/public/images/docs/diagrams/19_2_batching_after.dark.png
new file mode 100644
index 000000000..29ff14093
Binary files /dev/null and b/public/images/docs/diagrams/19_2_batching_after.dark.png differ
diff --git a/public/images/docs/diagrams/19_2_batching_after.png b/public/images/docs/diagrams/19_2_batching_after.png
new file mode 100644
index 000000000..0ae652f79
Binary files /dev/null and b/public/images/docs/diagrams/19_2_batching_after.png differ
diff --git a/public/images/docs/diagrams/19_2_batching_before.dark.png b/public/images/docs/diagrams/19_2_batching_before.dark.png
new file mode 100644
index 000000000..758afceb1
Binary files /dev/null and b/public/images/docs/diagrams/19_2_batching_before.dark.png differ
diff --git a/public/images/docs/diagrams/19_2_batching_before.png b/public/images/docs/diagrams/19_2_batching_before.png
new file mode 100644
index 000000000..7e260135f
Binary files /dev/null and b/public/images/docs/diagrams/19_2_batching_before.png differ
diff --git a/public/images/docs/performance-tracks/changed-props.dark.png b/public/images/docs/performance-tracks/changed-props.dark.png
new file mode 100644
index 000000000..6709a7ea8
Binary files /dev/null and b/public/images/docs/performance-tracks/changed-props.dark.png differ
diff --git a/public/images/docs/performance-tracks/changed-props.png b/public/images/docs/performance-tracks/changed-props.png
new file mode 100644
index 000000000..33efe9289
Binary files /dev/null and b/public/images/docs/performance-tracks/changed-props.png differ
diff --git a/public/images/docs/performance-tracks/components-effects.dark.png b/public/images/docs/performance-tracks/components-effects.dark.png
new file mode 100644
index 000000000..57e3a30b0
Binary files /dev/null and b/public/images/docs/performance-tracks/components-effects.dark.png differ
diff --git a/public/images/docs/performance-tracks/components-effects.png b/public/images/docs/performance-tracks/components-effects.png
new file mode 100644
index 000000000..ff315b99d
Binary files /dev/null and b/public/images/docs/performance-tracks/components-effects.png differ
diff --git a/public/images/docs/performance-tracks/components-render.dark.png b/public/images/docs/performance-tracks/components-render.dark.png
new file mode 100644
index 000000000..c0608b153
Binary files /dev/null and b/public/images/docs/performance-tracks/components-render.dark.png differ
diff --git a/public/images/docs/performance-tracks/components-render.png b/public/images/docs/performance-tracks/components-render.png
new file mode 100644
index 000000000..436737767
Binary files /dev/null and b/public/images/docs/performance-tracks/components-render.png differ
diff --git a/public/images/docs/performance-tracks/overview.dark.png b/public/images/docs/performance-tracks/overview.dark.png
new file mode 100644
index 000000000..07513fe90
Binary files /dev/null and b/public/images/docs/performance-tracks/overview.dark.png differ
diff --git a/public/images/docs/performance-tracks/overview.png b/public/images/docs/performance-tracks/overview.png
new file mode 100644
index 000000000..835a247cf
Binary files /dev/null and b/public/images/docs/performance-tracks/overview.png differ
diff --git a/public/images/docs/performance-tracks/scheduler-cascading-update.dark.png b/public/images/docs/performance-tracks/scheduler-cascading-update.dark.png
new file mode 100644
index 000000000..beb4512d2
Binary files /dev/null and b/public/images/docs/performance-tracks/scheduler-cascading-update.dark.png differ
diff --git a/public/images/docs/performance-tracks/scheduler-cascading-update.png b/public/images/docs/performance-tracks/scheduler-cascading-update.png
new file mode 100644
index 000000000..8631c4896
Binary files /dev/null and b/public/images/docs/performance-tracks/scheduler-cascading-update.png differ
diff --git a/public/images/docs/performance-tracks/scheduler-update.dark.png b/public/images/docs/performance-tracks/scheduler-update.dark.png
new file mode 100644
index 000000000..df252663a
Binary files /dev/null and b/public/images/docs/performance-tracks/scheduler-update.dark.png differ
diff --git a/public/images/docs/performance-tracks/scheduler-update.png b/public/images/docs/performance-tracks/scheduler-update.png
new file mode 100644
index 000000000..79a361d2a
Binary files /dev/null and b/public/images/docs/performance-tracks/scheduler-update.png differ
diff --git a/public/images/docs/performance-tracks/scheduler.dark.png b/public/images/docs/performance-tracks/scheduler.dark.png
new file mode 100644
index 000000000..7e48020f8
Binary files /dev/null and b/public/images/docs/performance-tracks/scheduler.dark.png differ
diff --git a/public/images/docs/performance-tracks/scheduler.png b/public/images/docs/performance-tracks/scheduler.png
new file mode 100644
index 000000000..1cd07a144
Binary files /dev/null and b/public/images/docs/performance-tracks/scheduler.png differ
diff --git a/public/images/docs/performance-tracks/server-overview.dark.png b/public/images/docs/performance-tracks/server-overview.dark.png
new file mode 100644
index 000000000..221fb1204
Binary files /dev/null and b/public/images/docs/performance-tracks/server-overview.dark.png differ
diff --git a/public/images/docs/performance-tracks/server-overview.png b/public/images/docs/performance-tracks/server-overview.png
new file mode 100644
index 000000000..85c7eed27
Binary files /dev/null and b/public/images/docs/performance-tracks/server-overview.png differ
diff --git a/public/images/docs/scientists/1bX5QH6.jpg b/public/images/docs/scientists/1bX5QH6.jpg
new file mode 100644
index 000000000..630b91bd2
Binary files /dev/null and b/public/images/docs/scientists/1bX5QH6.jpg differ
diff --git a/public/images/docs/scientists/1bX5QH6b.jpg b/public/images/docs/scientists/1bX5QH6b.jpg
new file mode 100644
index 000000000..7bd074365
Binary files /dev/null and b/public/images/docs/scientists/1bX5QH6b.jpg differ
diff --git a/public/images/docs/scientists/1bX5QH6s.jpg b/public/images/docs/scientists/1bX5QH6s.jpg
new file mode 100644
index 000000000..0bc3a6f40
Binary files /dev/null and b/public/images/docs/scientists/1bX5QH6s.jpg differ
diff --git a/public/images/docs/scientists/2heNQDcm.jpg b/public/images/docs/scientists/2heNQDcm.jpg
new file mode 100644
index 000000000..ecc8ab394
Binary files /dev/null and b/public/images/docs/scientists/2heNQDcm.jpg differ
diff --git a/public/images/docs/scientists/3aIiwfm.jpg b/public/images/docs/scientists/3aIiwfm.jpg
new file mode 100644
index 000000000..e93d8c802
Binary files /dev/null and b/public/images/docs/scientists/3aIiwfm.jpg differ
diff --git a/public/images/docs/scientists/5qwVYb1.jpeg b/public/images/docs/scientists/5qwVYb1.jpeg
new file mode 100644
index 000000000..cd8b4e556
Binary files /dev/null and b/public/images/docs/scientists/5qwVYb1.jpeg differ
diff --git a/public/images/docs/scientists/6o5Vuyu.jpg b/public/images/docs/scientists/6o5Vuyu.jpg
new file mode 100644
index 000000000..941563f8d
Binary files /dev/null and b/public/images/docs/scientists/6o5Vuyu.jpg differ
diff --git a/public/images/docs/scientists/7vQD0fPb.jpg b/public/images/docs/scientists/7vQD0fPb.jpg
new file mode 100644
index 000000000..71baab951
Binary files /dev/null and b/public/images/docs/scientists/7vQD0fPb.jpg differ
diff --git a/public/images/docs/scientists/7vQD0fPs.jpg b/public/images/docs/scientists/7vQD0fPs.jpg
new file mode 100644
index 000000000..5da6b45f1
Binary files /dev/null and b/public/images/docs/scientists/7vQD0fPs.jpg differ
diff --git a/public/images/docs/scientists/9EAYZrtl.jpg b/public/images/docs/scientists/9EAYZrtl.jpg
new file mode 100644
index 000000000..7313ffdb2
Binary files /dev/null and b/public/images/docs/scientists/9EAYZrtl.jpg differ
diff --git a/public/images/docs/scientists/AlHTAdDm.jpg b/public/images/docs/scientists/AlHTAdDm.jpg
new file mode 100644
index 000000000..735c29cd5
Binary files /dev/null and b/public/images/docs/scientists/AlHTAdDm.jpg differ
diff --git a/public/images/docs/scientists/DgXHVwul.jpg b/public/images/docs/scientists/DgXHVwul.jpg
new file mode 100644
index 000000000..a9dba869c
Binary files /dev/null and b/public/images/docs/scientists/DgXHVwul.jpg differ
diff --git a/public/images/docs/scientists/FJeJR8M.jpg b/public/images/docs/scientists/FJeJR8M.jpg
new file mode 100644
index 000000000..433fc3503
Binary files /dev/null and b/public/images/docs/scientists/FJeJR8M.jpg differ
diff --git a/public/images/docs/scientists/HMFmH6m.jpg b/public/images/docs/scientists/HMFmH6m.jpg
new file mode 100644
index 000000000..ac0a5f6c3
Binary files /dev/null and b/public/images/docs/scientists/HMFmH6m.jpg differ
diff --git a/public/images/docs/scientists/IOjWm71s.jpg b/public/images/docs/scientists/IOjWm71s.jpg
new file mode 100644
index 000000000..af912e34b
Binary files /dev/null and b/public/images/docs/scientists/IOjWm71s.jpg differ
diff --git a/public/images/docs/scientists/JBbMpWY.jpg b/public/images/docs/scientists/JBbMpWY.jpg
new file mode 100644
index 000000000..a59002bca
Binary files /dev/null and b/public/images/docs/scientists/JBbMpWY.jpg differ
diff --git a/public/images/docs/scientists/K9HVAGHl.jpg b/public/images/docs/scientists/K9HVAGHl.jpg
new file mode 100644
index 000000000..03894f397
Binary files /dev/null and b/public/images/docs/scientists/K9HVAGHl.jpg differ
diff --git a/public/images/docs/scientists/MK3eW3Am.jpg b/public/images/docs/scientists/MK3eW3Am.jpg
new file mode 100644
index 000000000..53287dd02
Binary files /dev/null and b/public/images/docs/scientists/MK3eW3Am.jpg differ
diff --git a/public/images/docs/scientists/MK3eW3As.jpg b/public/images/docs/scientists/MK3eW3As.jpg
new file mode 100644
index 000000000..43244d0c5
Binary files /dev/null and b/public/images/docs/scientists/MK3eW3As.jpg differ
diff --git a/public/images/docs/scientists/Mx7dA2Y.jpg b/public/images/docs/scientists/Mx7dA2Y.jpg
new file mode 100644
index 000000000..ee41fbbaf
Binary files /dev/null and b/public/images/docs/scientists/Mx7dA2Y.jpg differ
diff --git a/public/images/docs/scientists/OKS67lhb.jpg b/public/images/docs/scientists/OKS67lhb.jpg
new file mode 100644
index 000000000..71d2917a7
Binary files /dev/null and b/public/images/docs/scientists/OKS67lhb.jpg differ
diff --git a/public/images/docs/scientists/OKS67lhm.jpg b/public/images/docs/scientists/OKS67lhm.jpg
new file mode 100644
index 000000000..9fe8f6307
Binary files /dev/null and b/public/images/docs/scientists/OKS67lhm.jpg differ
diff --git a/public/images/docs/scientists/OKS67lhs.jpg b/public/images/docs/scientists/OKS67lhs.jpg
new file mode 100644
index 000000000..fb3cf212c
Binary files /dev/null and b/public/images/docs/scientists/OKS67lhs.jpg differ
diff --git a/public/images/docs/scientists/QIrZWGIs.jpg b/public/images/docs/scientists/QIrZWGIs.jpg
new file mode 100644
index 000000000..2bfa8ab82
Binary files /dev/null and b/public/images/docs/scientists/QIrZWGIs.jpg differ
diff --git a/public/images/docs/scientists/QwUKKmF.jpg b/public/images/docs/scientists/QwUKKmF.jpg
new file mode 100644
index 000000000..05aa061ea
Binary files /dev/null and b/public/images/docs/scientists/QwUKKmF.jpg differ
diff --git a/public/images/docs/scientists/RCwLEoQm.jpg b/public/images/docs/scientists/RCwLEoQm.jpg
new file mode 100644
index 000000000..4d7d0b6df
Binary files /dev/null and b/public/images/docs/scientists/RCwLEoQm.jpg differ
diff --git a/public/images/docs/scientists/Sd1AgUOm.jpg b/public/images/docs/scientists/Sd1AgUOm.jpg
new file mode 100644
index 000000000..b81b83d21
Binary files /dev/null and b/public/images/docs/scientists/Sd1AgUOm.jpg differ
diff --git a/public/images/docs/scientists/Y3utgTi.jpg b/public/images/docs/scientists/Y3utgTi.jpg
new file mode 100644
index 000000000..8d44e4fed
Binary files /dev/null and b/public/images/docs/scientists/Y3utgTi.jpg differ
diff --git a/public/images/docs/scientists/YfeOqp2b.jpg b/public/images/docs/scientists/YfeOqp2b.jpg
new file mode 100644
index 000000000..44e0c65cb
Binary files /dev/null and b/public/images/docs/scientists/YfeOqp2b.jpg differ
diff --git a/public/images/docs/scientists/YfeOqp2s.jpg b/public/images/docs/scientists/YfeOqp2s.jpg
new file mode 100644
index 000000000..19ef15704
Binary files /dev/null and b/public/images/docs/scientists/YfeOqp2s.jpg differ
diff --git a/public/images/docs/scientists/ZF6s192.jpg b/public/images/docs/scientists/ZF6s192.jpg
new file mode 100644
index 000000000..f50c7e348
Binary files /dev/null and b/public/images/docs/scientists/ZF6s192.jpg differ
diff --git a/public/images/docs/scientists/ZF6s192m.jpg b/public/images/docs/scientists/ZF6s192m.jpg
new file mode 100644
index 000000000..056f8d52b
Binary files /dev/null and b/public/images/docs/scientists/ZF6s192m.jpg differ
diff --git a/public/images/docs/scientists/ZfQOOzfl.jpg b/public/images/docs/scientists/ZfQOOzfl.jpg
new file mode 100644
index 000000000..5c9e249bd
Binary files /dev/null and b/public/images/docs/scientists/ZfQOOzfl.jpg differ
diff --git a/public/images/docs/scientists/aTtVpES.jpg b/public/images/docs/scientists/aTtVpES.jpg
new file mode 100644
index 000000000..00e09d093
Binary files /dev/null and b/public/images/docs/scientists/aTtVpES.jpg differ
diff --git a/public/images/docs/scientists/aeO3rpIl.jpg b/public/images/docs/scientists/aeO3rpIl.jpg
new file mode 100644
index 000000000..3b535b072
Binary files /dev/null and b/public/images/docs/scientists/aeO3rpIl.jpg differ
diff --git a/public/images/docs/scientists/bE7W1jis.jpg b/public/images/docs/scientists/bE7W1jis.jpg
new file mode 100644
index 000000000..a15a897ea
Binary files /dev/null and b/public/images/docs/scientists/bE7W1jis.jpg differ
diff --git a/public/images/docs/scientists/dB2LRbj.jpg b/public/images/docs/scientists/dB2LRbj.jpg
new file mode 100644
index 000000000..f2ac04825
Binary files /dev/null and b/public/images/docs/scientists/dB2LRbj.jpg differ
diff --git a/public/images/docs/scientists/jA8hHMpm.jpg b/public/images/docs/scientists/jA8hHMpm.jpg
new file mode 100644
index 000000000..ba2168f85
Binary files /dev/null and b/public/images/docs/scientists/jA8hHMpm.jpg differ
diff --git a/public/images/docs/scientists/kxsph5Cl.jpg b/public/images/docs/scientists/kxsph5Cl.jpg
new file mode 100644
index 000000000..f33360729
Binary files /dev/null and b/public/images/docs/scientists/kxsph5Cl.jpg differ
diff --git a/public/images/docs/scientists/lICfvbD.jpg b/public/images/docs/scientists/lICfvbD.jpg
new file mode 100644
index 000000000..67393f31e
Binary files /dev/null and b/public/images/docs/scientists/lICfvbD.jpg differ
diff --git a/public/images/docs/scientists/lrWQx8ls.jpg b/public/images/docs/scientists/lrWQx8ls.jpg
new file mode 100644
index 000000000..bc0708bd0
Binary files /dev/null and b/public/images/docs/scientists/lrWQx8ls.jpg differ
diff --git a/public/images/docs/scientists/mynHUSas.jpg b/public/images/docs/scientists/mynHUSas.jpg
new file mode 100644
index 000000000..e369df8c5
Binary files /dev/null and b/public/images/docs/scientists/mynHUSas.jpg differ
diff --git a/public/images/docs/scientists/okTpbHhm.jpg b/public/images/docs/scientists/okTpbHhm.jpg
new file mode 100644
index 000000000..a96c5c03c
Binary files /dev/null and b/public/images/docs/scientists/okTpbHhm.jpg differ
diff --git a/public/images/docs/scientists/rN7hY6om.jpg b/public/images/docs/scientists/rN7hY6om.jpg
new file mode 100644
index 000000000..3c7afe1f9
Binary files /dev/null and b/public/images/docs/scientists/rN7hY6om.jpg differ
diff --git a/public/images/docs/scientists/rTqKo46l.jpg b/public/images/docs/scientists/rTqKo46l.jpg
new file mode 100644
index 000000000..4a0b3dc3b
Binary files /dev/null and b/public/images/docs/scientists/rTqKo46l.jpg differ
diff --git a/public/images/docs/scientists/szV5sdGb.jpg b/public/images/docs/scientists/szV5sdGb.jpg
new file mode 100644
index 000000000..8d6579402
Binary files /dev/null and b/public/images/docs/scientists/szV5sdGb.jpg differ
diff --git a/public/images/docs/scientists/szV5sdGs.jpg b/public/images/docs/scientists/szV5sdGs.jpg
new file mode 100644
index 000000000..fc3c34260
Binary files /dev/null and b/public/images/docs/scientists/szV5sdGs.jpg differ
diff --git a/public/images/docs/scientists/wIdGuZwm.png b/public/images/docs/scientists/wIdGuZwm.png
new file mode 100644
index 000000000..5f482def6
Binary files /dev/null and b/public/images/docs/scientists/wIdGuZwm.png differ
diff --git a/public/images/docs/scientists/yXOvdOSs.jpg b/public/images/docs/scientists/yXOvdOSs.jpg
new file mode 100644
index 000000000..0a3269510
Binary files /dev/null and b/public/images/docs/scientists/yXOvdOSs.jpg differ
diff --git a/public/images/docs/scientists/z08o2TS.jpg b/public/images/docs/scientists/z08o2TS.jpg
new file mode 100644
index 000000000..42a0a00ef
Binary files /dev/null and b/public/images/docs/scientists/z08o2TS.jpg differ
diff --git a/public/images/team/gh-aurorascharff.jpg b/public/images/team/gh-aurorascharff.jpg
new file mode 100644
index 000000000..10476e5e8
Binary files /dev/null and b/public/images/team/gh-aurorascharff.jpg differ
diff --git a/public/images/team/gh-brentvatne.jpg b/public/images/team/gh-brentvatne.jpg
new file mode 100644
index 000000000..c66a5cd6d
Binary files /dev/null and b/public/images/team/gh-brentvatne.jpg differ
diff --git a/public/images/team/gh-captbaritone.jpg b/public/images/team/gh-captbaritone.jpg
new file mode 100644
index 000000000..0100fa16b
Binary files /dev/null and b/public/images/team/gh-captbaritone.jpg differ
diff --git a/public/images/team/gh-cipolleschi.png b/public/images/team/gh-cipolleschi.png
new file mode 100644
index 000000000..a90bec66e
Binary files /dev/null and b/public/images/team/gh-cipolleschi.png differ
diff --git a/public/images/team/gh-cortinico.jpg b/public/images/team/gh-cortinico.jpg
new file mode 100644
index 000000000..e806a103b
Binary files /dev/null and b/public/images/team/gh-cortinico.jpg differ
diff --git a/public/images/team/gh-fbmal7.jpg b/public/images/team/gh-fbmal7.jpg
new file mode 100644
index 000000000..0f79e181d
Binary files /dev/null and b/public/images/team/gh-fbmal7.jpg differ
diff --git a/public/images/team/gh-fkgozali.jpg b/public/images/team/gh-fkgozali.jpg
new file mode 100644
index 000000000..9f87e7efb
Binary files /dev/null and b/public/images/team/gh-fkgozali.jpg differ
diff --git a/public/images/team/gh-huntie.jpg b/public/images/team/gh-huntie.jpg
new file mode 100644
index 000000000..a4de75801
Binary files /dev/null and b/public/images/team/gh-huntie.jpg differ
diff --git a/public/images/team/gh-javache.jpg b/public/images/team/gh-javache.jpg
new file mode 100644
index 000000000..1f63907ea
Binary files /dev/null and b/public/images/team/gh-javache.jpg differ
diff --git a/public/images/team/gh-khalef1.jpg b/public/images/team/gh-khalef1.jpg
new file mode 100644
index 000000000..94d96f670
Binary files /dev/null and b/public/images/team/gh-khalef1.jpg differ
diff --git a/public/images/team/gh-kmagiera.jpg b/public/images/team/gh-kmagiera.jpg
new file mode 100644
index 000000000..0e03ecb77
Binary files /dev/null and b/public/images/team/gh-kmagiera.jpg differ
diff --git a/public/images/team/gh-motiz88.jpg b/public/images/team/gh-motiz88.jpg
new file mode 100644
index 000000000..a67e30b1b
Binary files /dev/null and b/public/images/team/gh-motiz88.jpg differ
diff --git a/public/images/team/gh-robhogan.jpg b/public/images/team/gh-robhogan.jpg
new file mode 100644
index 000000000..4d5a5e830
Binary files /dev/null and b/public/images/team/gh-robhogan.jpg differ
diff --git a/public/images/team/gh-rubennorte.jpg b/public/images/team/gh-rubennorte.jpg
new file mode 100644
index 000000000..459c267e4
Binary files /dev/null and b/public/images/team/gh-rubennorte.jpg differ
diff --git a/public/images/team/gh-samselikoff.jpg b/public/images/team/gh-samselikoff.jpg
new file mode 100644
index 000000000..7887765b4
Binary files /dev/null and b/public/images/team/gh-samselikoff.jpg differ
diff --git a/public/images/team/gh-simek.png b/public/images/team/gh-simek.png
new file mode 100644
index 000000000..23a950103
Binary files /dev/null and b/public/images/team/gh-simek.png differ
diff --git a/public/images/team/gh-stmoy.jpg b/public/images/team/gh-stmoy.jpg
new file mode 100644
index 000000000..7694a7fb6
Binary files /dev/null and b/public/images/team/gh-stmoy.jpg differ
diff --git a/public/images/team/gh-thymikee.jpg b/public/images/team/gh-thymikee.jpg
new file mode 100644
index 000000000..d0debc5be
Binary files /dev/null and b/public/images/team/gh-thymikee.jpg differ
diff --git a/public/images/team/gh-vzaidman.jpg b/public/images/team/gh-vzaidman.jpg
new file mode 100644
index 000000000..c76905615
Binary files /dev/null and b/public/images/team/gh-vzaidman.jpg differ
diff --git a/public/images/team/jimmy-lai.jpg b/public/images/team/jimmy-lai.jpg
new file mode 100644
index 000000000..57b50c800
Binary files /dev/null and b/public/images/team/jimmy-lai.jpg differ
diff --git a/public/images/tutorial/codesandbox-devtools.png b/public/images/tutorial/codesandbox-devtools.png
deleted file mode 100644
index 1f7ebd500..000000000
Binary files a/public/images/tutorial/codesandbox-devtools.png and /dev/null differ
diff --git a/public/images/tutorial/components-tab.png b/public/images/tutorial/components-tab.png
new file mode 100644
index 000000000..90ce0770e
Binary files /dev/null and b/public/images/tutorial/components-tab.png differ
diff --git a/public/images/tutorial/devtools-inspect.gif b/public/images/tutorial/devtools-inspect.gif
new file mode 100644
index 000000000..5c623e6a7
Binary files /dev/null and b/public/images/tutorial/devtools-inspect.gif differ
diff --git a/public/images/tutorial/devtools-select.gif b/public/images/tutorial/devtools-select.gif
deleted file mode 100644
index dd1e1aa61..000000000
Binary files a/public/images/tutorial/devtools-select.gif and /dev/null differ
diff --git a/public/images/tutorial/sandbox-new-tab.png b/public/images/tutorial/sandbox-new-tab.png
new file mode 100644
index 000000000..093a363fb
Binary files /dev/null and b/public/images/tutorial/sandbox-new-tab.png differ
diff --git a/scripts/buildRscWorker.mjs b/scripts/buildRscWorker.mjs
new file mode 100644
index 000000000..b02cb8f43
--- /dev/null
+++ b/scripts/buildRscWorker.mjs
@@ -0,0 +1,44 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import * as esbuild from 'esbuild';
+import fs from 'fs';
+import path from 'path';
+import {fileURLToPath} from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const root = path.resolve(__dirname, '..');
+const sandboxBase = path.resolve(
+ root,
+ 'src/components/MDX/Sandpack/sandpack-rsc/sandbox-code/src'
+);
+
+// 1. Bundle the server Worker runtime (React server build + RSDW/server.browser + Sucrase → IIFE)
+// Minified because this runs inside a Web Worker (not parsed by Sandpack's Babel).
+const workerOutfile = path.resolve(sandboxBase, 'worker-bundle.dist.js');
+await esbuild.build({
+ entryPoints: [path.resolve(sandboxBase, 'rsc-server.js')],
+ bundle: true,
+ format: 'iife',
+ platform: 'browser',
+ conditions: ['react-server', 'browser'],
+ outfile: workerOutfile,
+ define: {'process.env.NODE_ENV': '"production"'},
+ minify: true,
+});
+
+// Post-process worker bundle:
+// Prepend the webpack shim so __webpack_require__ (used by react-server-dom-webpack)
+// is defined before the IIFE evaluates. The shim sets globalThis.__webpack_require__,
+// which is accessible as a bare identifier since globalThis IS the Worker's global scope.
+let workerCode = fs.readFileSync(workerOutfile, 'utf8');
+
+const shimPath = path.resolve(sandboxBase, 'webpack-shim.js');
+const shimCode = fs.readFileSync(shimPath, 'utf8');
+workerCode = shimCode + '\n' + workerCode;
+
+fs.writeFileSync(workerOutfile, workerCode);
diff --git a/scripts/deadLinkChecker.js b/scripts/deadLinkChecker.js
index 46a21cdc9..9c9fa852d 100644
--- a/scripts/deadLinkChecker.js
+++ b/scripts/deadLinkChecker.js
@@ -311,7 +311,11 @@ async function buildContributorMap() {
async function fetchErrorCodes() {
try {
const response = await fetch(
+<<<<<<< HEAD
'https://raw.githubusercontent.com/facebook/react/main/scripts/error-codes/codes.json'
+=======
+ 'https://raw.githubusercontent.com/react/react/main/scripts/error-codes/codes.json'
+>>>>>>> 46a54e0592729712b7640308b53268e84fdc7c9f
);
if (!response.ok) {
throw new Error(`Failed to fetch error codes: ${response.status}`);
diff --git a/scripts/generateOgImages.mjs b/scripts/generateOgImages.mjs
new file mode 100644
index 000000000..bc805d386
--- /dev/null
+++ b/scripts/generateOgImages.mjs
@@ -0,0 +1,247 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+// Generates a static OG image for every content page, so social
+// cards show the page title without any runtime image generation.
+// Run after `next build` (see the `build` script in package.json).
+
+import fs from 'fs';
+import path from 'path';
+import satori from 'satori';
+import {Resvg} from '@resvg/resvg-js';
+import matter from 'gray-matter';
+import opentype from '@shuding/opentype.js';
+
+const ROOT = process.cwd();
+const CONTENT_DIR = path.join(ROOT, 'src', 'content');
+const OUT_DIR = path.join(ROOT, 'public', 'images', 'og');
+const CONCURRENCY = 8;
+
+const SECTION_LABELS = {
+ learn: 'Learn React',
+ reference: 'API Reference',
+ community: 'Community',
+ blog: 'Blog',
+};
+
+const bold = fs.readFileSync(
+ path.join(ROOT, 'public', 'fonts', 'Optimistic_Display_W_Bd.ttf')
+);
+const medium = fs.readFileSync(
+ path.join(ROOT, 'public', 'fonts', 'Optimistic_Display_W_Md.ttf')
+);
+
+// Title area width: card width minus the horizontal padding (80px per side).
+const TITLE_MAX_WIDTH = 1200 - 80 * 2;
+const TITLE_MAX_FONT = 96;
+const TITLE_MIN_FONT = 56;
+// Small margin so borderline titles don't wrap and orphan a single trailing
+// character (e.g. the "p" in "renderToStaticMarkup", which is 1px too wide
+// to fit on one line at 96px).
+const TITLE_SAFETY = 8;
+
+const boldFont = opentype.parse(
+ bold.buffer.slice(bold.byteOffset, bold.byteOffset + bold.byteLength)
+);
+
+// Multi-word titles wrap cleanly at spaces, so a length bucket is fine for
+// them. Single-word titles (most API names) can only break mid-word, which
+// leaves an orphaned letter on its own line, so instead shrink them just
+// enough to fit on a single line.
+function titleFontSize(title) {
+ const trimmed = title.trim();
+ if (/\s/.test(trimmed)) {
+ return trimmed.length > 24 ? 72 : 96;
+ }
+ const widthPerPx = boldFont.getAdvanceWidth(trimmed, 1);
+ const fit = Math.floor((TITLE_MAX_WIDTH - TITLE_SAFETY) / widthPerPx);
+ return Math.max(TITLE_MIN_FONT, Math.min(TITLE_MAX_FONT, fit));
+}
+
+function el(type, style, children) {
+ return {type, props: {style, children}};
+}
+
+function card(title, pagePath) {
+ const section = pagePath.split('/')[1] ?? '';
+ const label = SECTION_LABELS[section] ?? 'React';
+ const logo = {
+ type: 'svg',
+ props: {
+ width: 80,
+ height: 72,
+ viewBox: '-10.5 -9.45 21 18.9',
+ fill: 'none',
+ children: [
+ {type: 'circle', props: {cx: 0, cy: 0, r: 2, fill: '#58c4dc'}},
+ {
+ type: 'g',
+ props: {
+ stroke: '#58c4dc',
+ strokeWidth: 1,
+ fill: 'none',
+ children: [
+ {type: 'ellipse', props: {rx: 10, ry: 4.5}},
+ {
+ type: 'ellipse',
+ props: {rx: 10, ry: 4.5, transform: 'rotate(60)'},
+ },
+ {
+ type: 'ellipse',
+ props: {rx: 10, ry: 4.5, transform: 'rotate(120)'},
+ },
+ ],
+ },
+ },
+ ],
+ },
+ };
+ return el(
+ 'div',
+ {
+ width: '100%',
+ height: '100%',
+ display: 'flex',
+ flexDirection: 'column',
+ padding: '72px 80px',
+ backgroundColor: '#23272f',
+ backgroundImage:
+ 'radial-gradient(circle at 25% 30%, #343a46 0%, #23272f 55%)',
+ },
+ [
+ el('div', {display: 'flex', alignItems: 'center', gap: '20px'}, [
+ logo,
+ el(
+ 'div',
+ {
+ fontSize: 48,
+ fontFamily: 'Optimistic Display Bold',
+ color: '#f6f7f9',
+ },
+ 'React'
+ ),
+ ]),
+ el(
+ 'div',
+ {
+ flexGrow: 1,
+ display: 'flex',
+ alignItems: 'center',
+ fontSize: titleFontSize(title),
+ fontFamily: 'Optimistic Display Bold',
+ color: '#f6f7f9',
+ lineHeight: 1.1,
+ wordBreak: 'break-word',
+ },
+ title
+ ),
+ el(
+ 'div',
+ {
+ fontSize: 40,
+ fontFamily: 'Optimistic Display Medium',
+ color: '#99a1b3',
+ },
+ label
+ ),
+ ]
+ );
+}
+
+async function renderCard(title, pagePath) {
+ const svg = await satori(card(title, pagePath), {
+ width: 1200,
+ height: 630,
+ fonts: [
+ {
+ name: 'Optimistic Display Bold',
+ data: bold,
+ weight: 700,
+ style: 'normal',
+ },
+ {
+ name: 'Optimistic Display Medium',
+ data: medium,
+ weight: 500,
+ style: 'normal',
+ },
+ ],
+ });
+ return new Resvg(svg, {fitTo: {mode: 'width', value: 1200}}).render().asPng();
+}
+
+function collectSidebarTitles() {
+ const titles = new Map();
+ for (const name of fs.readdirSync(path.join(ROOT, 'src'))) {
+ if (!/^sidebar.*\.json$/.test(name)) continue;
+ const walk = (node) => {
+ if (node.path && node.title) {
+ titles.set(node.path, node.title);
+ }
+ for (const child of node.routes ?? []) walk(child);
+ };
+ walk(JSON.parse(fs.readFileSync(path.join(ROOT, 'src', name), 'utf8')));
+ }
+ return titles;
+}
+
+const sidebarTitles = collectSidebarTitles();
+
+function collectPages(dir, out) {
+ for (const entry of fs.readdirSync(dir, {withFileTypes: true})) {
+ const full = path.join(dir, entry.name);
+ if (entry.isDirectory()) {
+ collectPages(full, out);
+ } else if (entry.name.endsWith('.md')) {
+ const rel = path.relative(CONTENT_DIR, full).replace(/\.md$/, '');
+ const segments = rel.split(path.sep);
+ if (segments[segments.length - 1] === 'index') {
+ segments.pop();
+ }
+ const pagePath = '/' + segments.join('/');
+ if (pagePath === '/' || pagePath.startsWith('/errors')) {
+ continue;
+ }
+ const {data} = matter(fs.readFileSync(full, 'utf8'));
+ const title = data.title ?? sidebarTitles.get(pagePath);
+ if (title) {
+ out.push({title: String(title), pagePath});
+ }
+ }
+ }
+ return out;
+}
+
+export function ogImageFileName(pagePath) {
+ return pagePath.replace(/^\//, '').replace(/\//g, '-') + '.png';
+}
+
+async function main() {
+ const pages = collectPages(CONTENT_DIR, []);
+ fs.mkdirSync(OUT_DIR, {recursive: true});
+ let done = 0;
+ const queue = [...pages];
+ async function worker() {
+ for (;;) {
+ const page = queue.shift();
+ if (!page) return;
+ const png = await renderCard(page.title, page.pagePath);
+ fs.writeFileSync(path.join(OUT_DIR, ogImageFileName(page.pagePath)), png);
+ done++;
+ if (done % 100 === 0) {
+ console.log(`og-images: ${done}/${pages.length}`);
+ }
+ }
+ }
+ await Promise.all(Array.from({length: CONCURRENCY}, worker));
+ console.log(`og-images: generated ${done} images in public/images/og`);
+}
+
+main().catch((error) => {
+ console.error(error);
+ process.exit(1);
+});
diff --git a/src/components/ButtonLink.tsx b/src/components/ButtonLink.tsx
index bd98d5b38..dff09ed3a 100644
--- a/src/components/ButtonLink.tsx
+++ b/src/components/ButtonLink.tsx
@@ -33,7 +33,7 @@ function ButtonLink({
className,
'active:scale-[.98] transition-transform inline-flex font-bold items-center outline-none focus:outline-none focus-visible:outline focus-visible:outline-link focus:outline-offset-2 focus-visible:dark:focus:outline-link-dark leading-snug',
{
- 'bg-link text-white dark:bg-brand-dark dark:text-secondary hover:bg-opacity-80':
+ 'bg-link text-white dark:bg-brand-dark dark:text-gray-90 hover:bg-opacity-80':
type === 'primary',
'text-primary dark:text-primary-dark shadow-secondary-button-stroke dark:shadow-secondary-button-stroke-dark hover:bg-gray-40/5 active:bg-gray-40/10 hover:dark:bg-gray-60/5 active:dark:bg-gray-60/10':
type === 'secondary',
diff --git a/src/components/Layout/Footer.tsx b/src/components/Layout/Footer.tsx
index 6304937dd..eb3d4a585 100644
--- a/src/components/Layout/Footer.tsx
+++ b/src/components/Layout/Footer.tsx
@@ -344,8 +344,13 @@ export function Footer() {
+
+ {message}
+
+
);
}
diff --git a/src/components/MDX/TocContext.tsx b/src/components/MDX/TocContext.tsx
index 924e6e09e..804895369 100644
--- a/src/components/MDX/TocContext.tsx
+++ b/src/components/MDX/TocContext.tsx
@@ -20,3 +20,6 @@ export type TocItem = {
export type Toc = Array