Sync with react.dev @ e9a7cb1b #103

Original file line number	Diff line number	Diff line change
Expand Up		@@ -2,11 +2,13 @@
		"root": true,
		"extends": "next/core-web-vitals",
		"parser": "@typescript-eslint/parser",
	"plugins": ["@typescript-eslint"],
	"plugins": ["@typescript-eslint", "eslint-plugin-react-compiler"],
		"rules": {
		"no-unused-vars": "off",
	"@typescript-eslint/no-unused-vars": ["error", { "varsIgnorePattern": "^_" }],
	"react-hooks/exhaustive-deps": "error"
	"@typescript-eslint/no-unused-vars": ["error", {"varsIgnorePattern": "^_"}],
	"react-hooks/exhaustive-deps": "error",
	"react/no-unknown-property": ["error", {"ignore": ["meta"]}],
	"react-compiler/react-compiler": "error"
		},
		"env": {
		"node": true,
Expand Down

34 changes: 34 additions & 0 deletions .github/ISSUE_TEMPLATE/0-bug.yml

Show comments View file Open in desktop

Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,34 @@
	name: "🐛 Report a bug"
	description: "Report a problem on the website."
	title: "[Bug]: "
	labels: ["bug: unconfirmed"]
	body:
	- type: textarea
	attributes:
	label: Summary
	description: \|
	A clear and concise summary of what the bug is.
	placeholder: \|
	Example bug report:
	When I click the "Submit" button on "Feedback", nothing happens.
	validations:
	required: true
	- type: input
	attributes:
	label: Page
	description: \|
	What page(s) did you encounter this bug on?
	placeholder: \|
	https://react.dev/
	validations:
	required: true
	- type: textarea
	attributes:
	label: Details
	description: \|
	Please provide any additional details about the bug.
	placeholder: \|
	Example details:
	The "Submit" button is unresponsive. I've tried refreshing the page and using a different browser, but the issue persists.
	validations:
	required: false

34 changes: 34 additions & 0 deletions .github/ISSUE_TEMPLATE/1-typo.yml

Show comments View file Open in desktop

Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,34 @@
	name: "🤦 Typo or mistake"
	description: "Report a typo or mistake in the docs."
	title: "[Typo]: "
	labels: ["type: typos"]
	body:
	- type: textarea
	attributes:
	label: Summary
	description: \|
	A clear and concise summary of what the mistake is.
	placeholder: \|
	Example:
	The code example on the "useReducer" page includes an unused variable `nextId`.
	validations:
	required: true
	- type: input
	attributes:
	label: Page
	description: \|
	What page is the typo on?
	placeholder: \|
	https://react.dev/
	validations:
	required: true
	- type: textarea
	attributes:
	label: Details
	description: \|
	Please provide a explanation for why this is a mistake.
	placeholder: \|
	Example mistake:
	In the "useReducer" section of the "API Reference" page, the code example under "Writing a reducer function" includes an unused variable `nextId` that should be removed.
	validations:
	required: false

34 changes: 34 additions & 0 deletions .github/ISSUE_TEMPLATE/2-suggestion.yml

Show comments View file Open in desktop

Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,34 @@
	name: "💡 Suggestions"
	description: "Suggest a new page, section, or edit for an existing page."
	title: "[Suggestion]: "
	labels: ["type: documentation"]
	body:
	- type: textarea
	attributes:
	label: Summary
	description: \|
	A clear and concise summary of what we should add.
	placeholder: \|
	Example:
	Add a new page for how to use React with TypeScript.
	validations:
	required: true
	- type: input
	attributes:
	label: Page
	description: \|
	What page is this about?
	placeholder: \|
	https://react.dev/
	validations:
	required: false
	- type: textarea
	attributes:
	label: Details
	description: \|
	Please provide a explanation for what you're suggesting.
	placeholder: \|
	Example:
	I think it would be helpful to have a page that explains how to use React with TypeScript. This could include a basic example of a component written in TypeScript, and a link to the TypeScript documentation.
	validations:
	required: true

116 changes: 116 additions & 0 deletions .github/ISSUE_TEMPLATE/3-framework.yml

Show comments View file Open in desktop

Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,116 @@
	name: "📄 Suggest new framework"
	description: "I am a framework author applying to be included as a recommended framework."
	title: "[Framework]: "
	labels: ["type: framework"]
	body:
	- type: markdown
	attributes:
	value: \|
	## Apply to be included as a recommended React framework

	_This form is for framework authors to apply to be included as a recommended [React framework](https://react.dev/learn/start-a-new-react-project). If you are not a framework author, please contact the authors before submitting._

	Our goal when recommending a framework is to start developers with a React project that solves common problems like code splitting, data fetching, routing, and HTML generation without any extra work later. We believe this will allow users to get started quickly with React, and scale their app to production.

	While we understand that many frameworks may want to be featured, this page is not a place to advertise every possible React framework or all frameworks that you can add React to. There are many great frameworks that offer support for React that are not listed in our guides. The frameworks we recommend have invested significantly in the React ecosystem, and collaborated with the React team to be compatible with our [full-stack React architecture vision](https://react.dev/learn/start-a-new-react-project#which-features-make-up-the-react-teams-full-stack-architecture-vision).

	To be included, frameworks must meet the following criteria:

	- Free & open-source: must be open source and free to use.
	- Well maintained. must be actively maintained, providing bug fixes and improvements.
	- Active community: must have a sufficiently large and active community to support users.
	- Clear onboarding: must have clear install steps to install the React version of the framework.
	- Ecosystem compatibility: must support using the full range of libraries and tools in the React ecosystem.
	- Self-hosting option: must support an option to self-host applications without losing access to features.
	- Developer experience. must allow developers to be productive by supporting features like Fast Refresh.
	- User experience. must provide built-in support for common problems like routing and data-fetching.
	- Compatible with our future vision for React. React evolves over time, and frameworks that do not align with React’s direction risk isolating their users from the main React ecosystem over time. To be included on this page we must feel confident that the framework is setting its users up for success with React over time.

	Please note, we have reviewed most of the popular frameworks available today, so it is unlikely we have not considered your framework already. But if you think we missed something, please complete the application below.
	- type: input
	attributes:
	label: Name
	description: \|
	What is the name of your framework?
	validations:
	required: true
	- type: input
	attributes:
	label: Homepage
	description: \|
	What is the URL of your homepage?
	validations:
	required: true
	- type: input
	attributes:
	label: Install instructions
	description: \|
	What is the URL of your getting started guide?
	validations:
	required: true
	- type: dropdown
	attributes:
	label: Is your framework open source?
	description: \|
	We only recommend free and open source frameworks.
	options:
	- 'No'
	- 'Yes'
	validations:
	required: true
	- type: textarea
	attributes:
	label: Well maintained
	description: \|
	Please describe how your framework is actively maintained. Include recent releases, bug fixes, and improvements as examples.
	validations:
	required: true
	- type: textarea
	attributes:
	label: Active community
	description: \|
	Please describe your community. Include the size of your community, and links to community resources.
	validations:
	required: true
	- type: textarea
	attributes:
	label: Clear onboarding
	description: \|
	Please describe how a user can install your framework with React. Include links to any relevant documentation.
	validations:
	required: true
	- type: textarea
	attributes:
	label: Ecosystem compatibility
	description: \|
	Please describe any limitations your framework has with the React ecosystem. Include any libraries or tools that are not compatible with your framework.
	validations:
	required: true
	- type: textarea
	attributes:
	label: Self-hosting option
	description: \|
	Please describe how your framework supports self-hosting. Include any limitations to features when self-hosting. Also include whether you require a server to deploy your framework.
	validations:
	required: true
	- type: textarea
	attributes:
	label: Developer Experience
	description: \|
	Please describe how your framework provides a great developer experience. Include any limitations to React features like React DevTools, Chrome DevTools, and Fast Refresh.
	validations:
	required: true
	- type: textarea
	attributes:
	label: User Experience
	description: \|
	Please describe how your framework helps developers create high quality user experiences by solving common use-cases. Include specifics for how your framework offers built-in support for code-splitting, routing, HTML generation, and data-fetching in a way that avoids client/server waterfalls by default. Include details on how you offer features such as SSG and SSR.
	validations:
	required: true
	- type: textarea
	attributes:
	label: Compatible with our future vision for React
	description: \|
	Please describe how your framework aligns with our future vision for React. Include how your framework will evolve with React over time, and your plans to support future React features like React Server Components.
	validations:
	required: true

7 changes: 7 additions & 0 deletions .github/ISSUE_TEMPLATE/config.yml

Show comments View file Open in desktop

Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,7 @@
	contact_links:
	- name: 📃 Bugs in React
	url: https://github.com/facebook/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
	about: This issue tracker is not for support questions. Please refer to the React community's help and discussion forums.

28 changes: 19 additions & 9 deletions .github/workflows/analyze.yml

Show comments View file Open in desktop

Original file line number	Diff line number	Diff line change
Expand Up		@@ -7,22 +7,32 @@ on:
		- main # change this if your default branch is named differently
		workflow_dispatch:

	permissions: {}

		jobs:
		analyze:
		runs-on: ubuntu-latest
		steps:
	- uses: actions/checkout@v2
	- uses: actions/checkout@v4

		- name: Set up node
	uses: actions/setup-node@v1
	uses: actions/setup-node@v4
		with:
		node-version: '20.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') }}

	- name: Install dependencies
	uses: bahmutov/npm-install@v1.7.10
	- name: Install deps
	run: yarn install --frozen-lockfile

		- name: Restore next build
	uses: actions/cache@v2
	uses: actions/cache@v4
		id: restore-build-cache
		env:
		cache-name: cache-next-build
Expand All		@@ -41,13 +51,13 @@ jobs:
		run: npx -p nextjs-bundle-analysis@0.5.0 report

		- name: Upload bundle
	uses: actions/upload-artifact@v2
	uses: actions/upload-artifact@v4
		with:
		path: .next/analyze/__bundle_analysis.json
		name: bundle_analysis.json

		- name: Download base branch bundle stats
	uses: dawidd6/action-download-artifact@v2
	uses: dawidd6/action-download-artifact@268677152d06ba59fcec7a7f0b5d961b6ccd7e1e
		if: success() && github.event.number
		with:
		workflow: analyze.yml
Expand All		@@ -73,7 +83,7 @@ jobs:
		run: ls -laR .next/analyze/base && npx -p nextjs-bundle-analysis compare

		- name: Upload analysis comment
	uses: actions/upload-artifact@v2
	uses: actions/upload-artifact@v4
		with:
		name: analysis_comment.txt
		path: .next/analyze/__bundle_analysis_comment.txt
Expand All		@@ -82,7 +92,7 @@ jobs:
		run: echo ${{ github.event.number }} > ./pr_number

		- name: Upload PR number
	uses: actions/upload-artifact@v2
	uses: actions/upload-artifact@v4
		with:
		name: pr_number
		path: ./pr_number
Expand Down

13 changes: 9 additions & 4 deletions .github/workflows/analyze_comment.yml

Show comments View file Open in desktop

Original file line number	Diff line number	Diff line change
Expand Up		@@ -2,10 +2,15 @@ name: Analyze Bundle (Comment)

		on:
		workflow_run:
	workflows: ["Analyze Bundle"]
	workflows: ['Analyze Bundle']
		types:
		- completed

	permissions:
	contents: read
	issues: write
	pull-requests: write

		jobs:
		comment:
		runs-on: ubuntu-latest
Expand All		@@ -14,15 +19,15 @@ jobs:
		github.event.workflow_run.conclusion == 'success' }}
		steps:
		- name: Download base branch bundle stats
	uses: dawidd6/action-download-artifact@v2
	uses: dawidd6/action-download-artifact@268677152d06ba59fcec7a7f0b5d961b6ccd7e1e
		with:
		workflow: analyze.yml
		run_id: ${{ github.event.workflow_run.id }}
		name: analysis_comment.txt
		path: analysis_comment.txt

		- name: Download PR number
	uses: dawidd6/action-download-artifact@v2
	uses: dawidd6/action-download-artifact@268677152d06ba59fcec7a7f0b5d961b6ccd7e1e
		with:
		workflow: analyze.yml
		run_id: ${{ github.event.workflow_run.id }}
Expand All		@@ -48,7 +53,7 @@ jobs:
		echo "pr-number=$pr_number" >> $GITHUB_OUTPUT

		- name: Comment
	uses: marocchino/sticky-pull-request-comment@v2
	uses: marocchino/sticky-pull-request-comment@52423e01640425a022ef5fd42c6fb5f633a02728
		with:
		header: next-bundle-analysis
		number: ${{ steps.get-comment-body.outputs.pr-number }}
Expand Down

32 changes: 32 additions & 0 deletions .github/workflows/discord_notify.yml

Show comments View file Open in desktop

Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,32 @@
	name: Discord Notify

	on:
	pull_request_target:
	types: [opened, ready_for_review]

	permissions: {}

	jobs:
	check_maintainer:
	uses: facebook/react/.github/workflows/shared_check_maintainer.yml@main
	permissions:
	# Used by check_maintainer
	contents: read
	with:
	actor: ${{ github.event.pull_request.user.login }}

	notify:
	if: ${{ needs.check_maintainer.outputs.is_core_team == 'true' }}
	needs: check_maintainer
	runs-on: ubuntu-latest
	steps:
	- name: Discord Webhook Action
	uses: tsickert/discord-webhook@v6.0.0
	with:
	webhook-url: ${{ secrets.DISCORD_WEBHOOK_URL }}
	embed-author-name: ${{ github.event.pull_request.user.login }}
	embed-author-url: ${{ github.event.pull_request.user.html_url }}
	embed-author-icon-url: ${{ github.event.pull_request.user.avatar_url }}
	embed-title: '#${{ github.event.number }} (+${{github.event.pull_request.additions}} -${{github.event.pull_request.deletions}}): ${{ github.event.pull_request.title }}'
	embed-description: ${{ github.event.pull_request.body }}
	embed-url: ${{ github.event.pull_request.html_url }}

Navigation Menu

Search code, repositories, users, issues, pull requests...

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Sync with react.dev @ e9a7cb1b #103

Are you sure you want to change the base?

Uh oh!

Sync with react.dev @ e9a7cb1b #103

Filter by extension

Uh oh!

Diff view

Diff view

Uh oh!

There are no files selected for viewing

Uh oh!

Uh oh!