Clean up links and add "No CRA" note

Author: markerikson

src/content/learn/creating-a-react-app.md

@@ -12,9 +12,9 @@ React can be used to build apps and websites in a variety of ways. Here's our re
 
 React is flexible. You can use it to build full-stack apps with integrated client and server functionality, in standalone client apps that work with any backend or just a browser, or even add React to an existing page generated by a server.
 
-We've found that most React apps have similar needs for data fetching and routing, and benefit from performance patterns like code splitting.  Because of this, we primarily **[recommend using a React-based framework](#bleeding-edge-react-frameworks)** as the best way to build a React app.  These frameworks provide good defaults, integrate these features, and provide room to grow your app over time.  (Similarly, other UI libraries also recommend integrated frameworks - Svelte has Sveltekit, Vue has Nuxt, and Solid has SolidStart.)
+We've found that most React apps have similar needs for data fetching and routing, and benefit from performance patterns like code splitting.  Because of this, we primarily **[recommend using a React-based framework](#recommended-react-frameworks)** as the best way to build a React app.  These frameworks provide good defaults, integrate these features, and provide room to grow your app over time.  (Similarly, other UI libraries also recommend integrated frameworks - Svelte has Sveltekit, Vue has Nuxt, and Solid has SolidStart.)
 
-If you want a simpler setup or are learning, you can **[start from scratch](#start-from-scratch)** with a lighter project setup, and we have suggestions for common tools that will help get your app going the right way.
+If you want a simpler setup or are learning, you can **[start from scratch](#start-from-scratch)** with a basic project, and we have suggestions for common tools that will help get your app going the right way.
 
 To learn more about the different ways to use React, see [the overview of web app architectures](/learn/web-app-architectures)
 
@@ -30,31 +30,28 @@ If your app uses Server-Side Rendering to generate pages, you'll need to deploy
 
 Note that **all of the full-stack frameworks on this page can also create standalone single-page apps that don't need an app server!**  If you would like to enable features that require a server (like Server-Side Rendering), you can later opt-in on individual routes without rewriting your app, and just change how you deploy it.
 
-
-
 </DeepDive>
 
-## Recommended React frameworks {/*bleeding-edge-react-frameworks*/}
-
-
+## Recommended React frameworks {/*recommended-react-frameworks*/}
 
 These recommended frameworks support all the features you need to deploy and scale your app in production. They have integrated the latest React features and take advantage of React’s architecture.
 
 
-
 ### Next.js (App Router) {/*nextjs-app-router*/}
 
-**[Next.js's App Router](https://nextjs.org/docs) is a React framework that takes full advantage of React's architecture to enable full-stack React apps.**
+**[Next.js's App Router](https://nextjs.org/docs) is a React framework that takes full advantage of React's architecture to enable full-stack React apps.** You can [deploy a Next.js app](https://nextjs.org/docs/app/building-your-application/deploying) to any Node.js or serverless hosting, or to your own server. Next.js also supports [static export](https://nextjs.org/docs/app/building-your-application/deploying/static-exports) which doesn't require a server.
+
+To create a new Next.js project, run:
 
 <TerminalBlock>
 npx create-next-app@latest
 </TerminalBlock>
 
-Next.js is maintained by [Vercel](https://vercel.com/). You can [deploy a Next.js app](https://nextjs.org/docs/app/building-your-application/deploying) to any Node.js or serverless hosting, or to your own server. Next.js also supports [static export](https://nextjs.org/docs/app/building-your-application/deploying/static-exports) which doesn't require a server. Vercel additionally provides opt-in paid cloud services.
+Next.js is maintained by [Vercel](https://vercel.com/).  Vercel additionally provides opt-in paid cloud services.
 
 ### React Router (v7) {/*react-router-v7*/}
 
-**[React Router](https://reactrouter.com/start/framework/installation) is the most popular routing library for React and can be paired with Vite to create a full-stack React framework**. It emphasizes standard Web APIs and has several [ready to deploy templates](https://github.com/remix-run/react-router-templates) for various JavaScript runtimes and platforms.
+**[React Router](https://reactrouter.com/start/framework/installation) is the most popular routing library for React. It can be paired with Vite to create a full-stack React framework**. It emphasizes standard Web APIs and has several [ready to deploy templates](https://github.com/remix-run/react-router-templates) for various JavaScript runtimes and platforms.
 
 To create a new React Router framework project, run:
 
@@ -66,7 +63,9 @@ React Router is maintained by [Shopify](https://www.shopify.com).
 
 ### Expo (for native apps) {/*expo*/}
 
-**[Expo](https://expo.dev/) is a React framework that lets you create universal Android, iOS, and web apps with truly native UIs.** It provides an SDK for [React Native](https://reactnative.dev/) that makes the native parts easier to use. To create a new Expo project, run:
+**[Expo](https://expo.dev/) is a React framework that lets you create universal Android, iOS, and web apps with truly native UIs.** It provides an SDK for [React Native](https://reactnative.dev/) that makes the native parts easier to use.
+
+To create a new Expo project, run:
 
 <TerminalBlock>
 npx create-expo-app@latest
@@ -122,7 +121,17 @@ Server Components and Suspense are React features rather than Next.js features.
 
 If you are learning React, are not using JS in your backend, only need client-side functionality, or want to design your app configuration yourself, there are other options available for starting a React project from scratch.
 
-Starting from scratch gives you more flexibility, but does require that you make choices on which tools to use for routing, data fetching, and other common usage patterns.  The [frameworks we recommend](#bleeding-edge-react-frameworks) have built-in solutions for these problems.  If you want to choose your own solutions, we have some recommendations for commonly-used tools.
+Starting from scratch gives you more flexibility, but does require that you make choices on which tools to use for routing, data fetching, and other common usage patterns.  The [frameworks we recommend](#recommended-react-frameworks) have built-in solutions for these problems.  If you want to choose your own solutions, we have some recommendations for commonly-used tools.
+
+<Note>
+
+#### Should I use the legacy Create React App tool? {/*should-i-use-legacy-cra*/}
+
+**No. We have officially deprecated Create React App - please _do not_ use it!**  The tools recommended on this page are faster, better maintained, and provide more features.
+
+For more information, see [Sunsetting Create React App](/blog/2025/02/14/sunsetting-create-react-app).
+
+</Note>
 
 ### Install a Build Tool {/*install-a-build-tool*/}
 
@@ -212,6 +221,8 @@ See [Web App Architectures](/learn/web-app-architectures) to learn more about po
 
 
 
+
+
 -----
 
 _If you’re a framework author interested in being included on this page, [please let us know](https://github.com/reactjs/react.dev/issues/new?assignees=&labels=type%3A+framework&projects=&template=3-framework.yml&title=%5BFramework%5D%3A+)._

src/content/learn/installation.md

@@ -34,11 +34,9 @@ To try React locally on your computer, [download this HTML page.](https://gist.g
 
 ## Creating a React App {/*creating-a-react-app*/}
 
-If you want to start a new React app, you can [create a React app](/learn/creating-a-react-app) using a recommended framework.
+If you want to start a new React app, you can [create a React app](/learn/creating-a-react-app#recommended-react-frameworks) using a recommended framework.
 
-## Build a React Framework {/*build-a-react-framework*/}
-
-If a framework is not a good fit for your project, or you prefer to start by building your own framework, you can [build your own React framework](/learn/building-a-react-framework).
+If a framework is not a good fit for your project, or you prefer to pick and choose your project's tools, you can [start from scratch](/learn/creating-a-react-app#start-from-scratch).
 
 ## Add React to an existing project {/*add-react-to-an-existing-project*/}
 

src/content/reference/rsc/directives.md

@@ -4,13 +4,13 @@ title: Directives
 
 <RSC>
 
-Directives are for use in [React Server Components](/learn/start-a-new-react-project#bleeding-edge-react-frameworks).
+Directives are for use in [React Server Components](/learn/start-a-new-react-project#recommended-react-frameworks).
 
 </RSC>
 
 <Intro>
 
-Directives provide instructions to [bundlers compatible with React Server Components](/learn/start-a-new-react-project#bleeding-edge-react-frameworks).
+Directives provide instructions to [bundlers compatible with React Server Components](/learn/start-a-new-react-project#recommended-react-frameworks).
 
 </Intro>
 

src/content/reference/rsc/server-components.md

@@ -4,7 +4,7 @@ title: Server Components
 
 <RSC>
 
-Server Components are for use in [React Server Components](/learn/start-a-new-react-project#bleeding-edge-react-frameworks).
+Server Components are for use in [React Server Components](/learn/start-a-new-react-project#recommended-react-frameworks).
 
 </RSC>
 

src/content/reference/rsc/server-functions.md

@@ -4,7 +4,7 @@ title: Server Functions
 
 <RSC>
 
-Server Functions are for use in [React Server Components](/learn/start-a-new-react-project#bleeding-edge-react-frameworks).
+Server Functions are for use in [React Server Components](/learn/start-a-new-react-project#recommended-react-frameworks).
 
 **Note:** Until September 2024, we referred to all Server Functions as "Server Actions". If a Server Function is passed to an action prop or called from inside an action then it is a Server Action, but not all Server Functions are Server Actions. The naming in this documentation has been updated to reflect that Server Functions can be used for multiple purposes.
 

src/content/reference/rsc/use-client.md

@@ -5,7 +5,7 @@ titleForTitleTag: "'use client' directive"
 
 <RSC>
 
-`'use client'` is for use with [React Server Components](/learn/start-a-new-react-project#bleeding-edge-react-frameworks).
+`'use client'` is for use with [React Server Components](/learn/start-a-new-react-project#recommended-react-frameworks).
 
 </RSC>
 
@@ -41,7 +41,7 @@ export default function RichTextEditor({ timestamp, text }) {
 }
 ```
 
-When a file marked with `'use client'` is imported from a Server Component, [compatible bundlers](/learn/start-a-new-react-project#bleeding-edge-react-frameworks) will treat the module import as a boundary between server-run and client-run code.
+When a file marked with `'use client'` is imported from a Server Component, [compatible bundlers](/learn/start-a-new-react-project#recommended-react-frameworks) will treat the module import as a boundary between server-run and client-run code.
 
 As dependencies of `RichTextEditor`, `formatDate` and `Button` will also be evaluated on the client regardless of whether their modules contain a `'use client'` directive. Note that a single module may be evaluated on the server when imported from server code and on the client when imported from client code.
 

src/content/reference/rsc/use-server.md

@@ -5,7 +5,7 @@ titleForTitleTag: "'use server' directive"
 
 <RSC>
 
-`'use server'` is for use with [using React Server Components](/learn/start-a-new-react-project#bleeding-edge-react-frameworks).
+`'use server'` is for use with [using React Server Components](/learn/start-a-new-react-project#recommended-react-frameworks).
 
 </RSC>