Skip to content

Commit 4ae19a9

Browse files
Remove CRA from React docs + add deprecation note (#5280)
1 parent 058fca7 commit 4ae19a9

File tree

2 files changed

+6
-3
lines changed

2 files changed

+6
-3
lines changed

hub/dev-environment/javascript/react-on-wsl.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Install React on Windows Subsystem for Linux
3-
description: Install React on Windows Subsystem for Linux (WSL) and start developing web apps with React components and the create-react-app toolchain.
3+
description: Install React on Windows Subsystem for Linux (WSL) and start developing web apps with React components and the Vite front-end build toolchain.
44
ms.topic: article
55
keywords: react, install react on wsl, install react on linux on windows, react and windows, react development with windows, react with windows 10, react on windows, react with wsl
66
ms.date: 03/30/2021

hub/dev-environment/javascript/react-overview.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,9 @@ React is an open-source JavaScript library for building front end user interface
1515

1616
React components are typically written in JavaScript and JSX (JavaScript XML) which is a JavaScript extension that looks like a lot like HTML, but has some syntax features that make it easier to do common tasks like registering event handlers for UI elements. A React component implements the **render** method, which returns the JSX representing the component's UI. In a web app, the JSX code returned by the component is translated into browser-compliant HTML rendered in the browser.
1717

18+
> [!IMPORTANT]
19+
> In February 2025, the React team [announced](https://react.dev/blog/2025/02/14/sunsetting-create-react-app) that Create React App (CRA) has been deprecated for new apps. The team recommends that existing apps migrate to a framework like Next.js or React Router or migrate to a build tool like Vite, Parcel, or RSBuild.
20+
1821
## Does React work on Windows?
1922

2023
Yes. Windows supports two different environments for developing React apps:
@@ -26,7 +29,7 @@ Yes. Windows supports two different environments for developing React apps:
2629

2730
Windows supports a wide range of scenarios for React developers, including:
2831

29-
- **Basic web apps**: If you are new to React and primarily interested in learning about building a basic web app with React, we recommend that you [install create-react-app directly on Windows](./react-on-windows.md). If you're planning to create a web app that will be deployed for production, you may want to consider [installing create-react-app on Windows Subsystem for Linux (WSL)](./react-on-wsl.md), for better performance speed, system call compatibility, and alignment between your local development environment and deployment environment (which is often a Linux server).
32+
- **Basic web apps**: If you are new to React and primarily interested in learning about building a basic web app with React, we recommend that you [create a React app using the vite frontend tooling on Windows](./react-on-windows.md). If you're planning to create a web app that will be deployed for production, you may want to consider [create a React app using the vite frontend tooling on Windows Subsystem for Linux (WSL)](./react-on-wsl.md), for better performance speed, system call compatibility, and alignment between your local development environment and deployment environment (which is often a Linux server).
3033

3134
- **Single-Page Apps (SPAs)**: These are websites that interact with the user by dynamically rewriting the current web page with new data from a server, rather than the browser default of loading entire new pages. If you want to build a static content-oriented SPA website, we recommend installing [Gatsby on WSL](./gatsby-on-wsl.md). If you want to build a server-rendered SPA website with a Node.js backend, we recommend [installing Next.js on WSL](./nextjs-on-wsl.md). (Though Next.js now also offers [static file serving](https://nextjs.org/docs/app/building-your-application/optimizing/static-assets)).
3235

@@ -82,7 +85,7 @@ React is a library, not a framework, so may require additional tools to create a
8285
- [Babel](https://babeljs.io/): A JavaScript compiler mainly used to convert ECMAScript 2015+ code into a backwards compatible version of JavaScript in current and older browsers or environments. It can also be helpful to use [babel-preset-env](https://babeljs.io/docs/en/babel-preset-env) so that you don't need to micromanage syntax transforms or browser polyfills and can define what internet browsers to support.
8386
- [ESLint](https://eslint.org/): A tool for identifying and reporting on patterns found in your JavaScript code that helps you make your code more consistent and avoid bugs.
8487
- [Enzyme](https://enzymejs.github.io/enzyme/): A JavaScript testing utility for React that makes it easier to test your React Components' output.
85-
- [Jest](https://jestjs.io/): A testing framework built into the create-react-app package to help with writing idiomatic JavaScript tests.
88+
- [Jest](https://jestjs.io/): A testing framework that works together with Babel to help with writing idiomatic JavaScript tests in React apps.
8689
- [Mocha](https://mochajs.org/): A testing framework that runs on Node.js and in the browser to help with asynchronous testing, reporting, and mapping uncaught exceptions to the correct test cases.
8790

8891
## React courses and tutorials

0 commit comments

Comments
 (0)