From 1fe729975de8ccf18bab6ddf1dbb2279efec9030 Mon Sep 17 00:00:00 2001
From: Mohamed Emad <8965415+TheGeekyM@users.noreply.github.com>
Date: Fri, 6 Nov 2026 09:14:36 +0200
Subject: [PATCH] Add a "Migrating from Create React App" docs page

<!--
Thank you for sending the PR!
---
 docusaurus/docs/getting-started.md            |  2 ++
 .../docs/migrating-from-create-react-app.md   | 35 +++++++++++++++++++
 docusaurus/website/sidebars.json              |  3 +-
 3 files changed, 39 insertions(+), 1 deletion(-)
 create mode 100644 docusaurus/docs/migrating-from-create-react-app.md

diff --git a/docusaurus/docs/getting-started.md b/docusaurus/docs/getting-started.md
index ef7da3006f0..cd1cd8a5f78 100644
--- a/docusaurus/docs/getting-started.md
+++ b/docusaurus/docs/getting-started.md
@@ -6,6 +6,8 @@ title: Getting Started
 Create React App is an officially supported way to create single-page React
 applications. It offers a modern build setup with no configuration.
 
+> Create React App is deprecated. If you have an existing app, see [Migrating from Create React App](migrating-from-create-react-app.md).
+
 ## Quick Start
 
 ```sh
diff --git a/docusaurus/docs/migrating-from-create-react-app.md b/docusaurus/docs/migrating-from-create-react-app.md
new file mode 100644
index 00000000000..57b5c3e7bb1
--- /dev/null
+++ b/docusaurus/docs/migrating-from-create-react-app.md
@@ -0,0 +1,35 @@
+---
+id: migrating-from-create-react-app
+title: Migrating from Create React App
+---
+
+Create React App is deprecated. The React team recommends moving existing apps to a framework, or to a build tool if you need a custom setup. See [Sunsetting Create React App](https://react.dev/blog/2025/02/14/sunsetting-create-react-app) for background.
+
+## Migration Guides
+
+### Frameworks
+
+- [Next.js](https://nextjs.org/docs/app/building-your-application/upgrading/from-create-react-app)
+- [React Router](https://reactrouter.com/upgrading/component-routes)
+- [Expo (webpack)](https://docs.expo.dev/router/migrate/from-expo-webpack/)
+
+### Build Tools
+
+- [Vite](https://www.robinwieruch.de/vite-create-react-app/)
+- [Parcel](https://parceljs.org/migration/cra/)
+- [Rsbuild](https://rsbuild.dev/guide/migration/cra)
+
+## Create React App Conventions to Translate
+
+Some behavior in Create React App is driven by conventions rather than explicit configuration. Check whether your app relies on any of the following, and look up the equivalent in the tool you are moving to.
+
+| Convention | What Create React App does | Docs |
+| --- | --- | --- |
+| `REACT_APP_*` environment variables | Variables starting with `REACT_APP_` (plus `NODE_ENV` and `PUBLIC_URL`) are embedded into the bundle as `process.env.*` (`config/env.js`). | [Adding Custom Environment Variables](adding-custom-environment-variables.md) |
+| `PUBLIC_URL` and `homepage` | The public path is taken from the `PUBLIC_URL` environment variable or the `homepage` field in `package.json` (`config/paths.js`). | [Deployment](deployment.md#building-for-relative-paths) |
+| `%PUBLIC_URL%` in `public/index.html` | Replaced with the public path at build time. | [Using the Public Folder](using-the-public-folder.md) |
+| `proxy` in `package.json` | Unknown requests in development are proxied to this address. | [Proxying API Requests in Development](proxying-api-requests-in-development.md) |
+| `src/setupProxy.js` | Loaded automatically to register custom development proxy middleware (`config/paths.js`). | [Proxying API Requests in Development](proxying-api-requests-in-development.md#configuring-the-proxy-manually) |
+| `baseUrl` in `jsconfig.json` / `tsconfig.json` | Enables absolute imports from `src` (`config/modules.js`). | [Importing a Component](importing-a-component.md#absolute-imports) |
+| `import { ReactComponent } from './logo.svg'` | SVG files can be imported as React components. | [Adding Images, Fonts, and Files](adding-images-fonts-and-files.md#adding-svgs) |
+| `browserslist` in `package.json` | Determines the browsers targeted by the JavaScript and CSS output. | [Supported Browsers and Features](supported-browsers-features.md) |
diff --git a/docusaurus/website/sidebars.json b/docusaurus/website/sidebars.json
index 386a29da1bf..4f980796da4 100644
--- a/docusaurus/website/sidebars.json
+++ b/docusaurus/website/sidebars.json
@@ -6,7 +6,8 @@
       "folder-structure",
       "available-scripts",
       "supported-browsers-features",
-      "updating-to-new-releases"
+      "updating-to-new-releases",
+      "migrating-from-create-react-app"
     ],
     "Development": [
       "setting-up-your-editor",