Skip to content

Commit 2197bc6

Browse files
authored
Add nvm repo install link (#4119)
* Add nvm repo install link * Update intro * Remove windows-or-wsl.md * Add redirect for windows vs wsl node page * Remove links to wsl vs windows * Update create react app install on windows
1 parent 3153598 commit 2197bc6

14 files changed

+24
-63
lines changed

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7714,6 +7714,11 @@
77147714
"source_path": "hub/apps/distribute-through-store/best-practices-for-win32-app-distribution.md",
77157715
"redirect_url": "hub/apps/distribute-through-store/how-to-distribute-your-win32-app-through-microsoft-store.md",
77167716
"redirect_document_id": false
7717+
},
7718+
{
7719+
"source_path": "hub/dev-environment/javascript/windows-or-wsl.md",
7720+
"redirect_url": "hub/dev-environment/javascript/nodejs-overview.md",
7721+
"redirect_document_id": false
77177722
}
77187723
]
77197724
}

hub/dev-environment/javascript/nodejs-beginners-tutorial.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,8 +22,6 @@ If you're brand new to using Node.js, this guide will help you to get started wi
2222

2323
- Installing on Node.js on [Windows](./nodejs-on-windows.md) or on [Windows Subsystem for Linux](./nodejs-on-wsl.md)
2424

25-
If you are a beginner, trying Node.js for the first time, we recommend installing directly on Windows. For more information, see [Should I install Node.js on Windows or Windows Subsystem for Linux](./windows-or-wsl.md)
26-
2725
## Try NodeJS with Visual Studio Code
2826

2927
If you have not yet installed Visual Studio Code, return to the prerequisite section above and follow the installation steps linked for Windows or WSL.

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

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,14 @@ ms.author: mattwoj
66
manager: jken
77
ms.topic: article
88
ms.localizationpriority: medium
9-
ms.date: 05/19/2022
9+
ms.date: 03/01/2024
1010
---
1111

1212
# Install Node.js on Windows Subsystem for Linux (WSL2)
1313

14-
If you are using Node.js professionally, find performance speed and system call compatibility important, want to run [Docker containers](/windows/wsl/tutorials/wsl-containers) that leverage Linux workspaces and avoid having to maintain both Linux and Windows build scripts, or just prefer using a Bash command line, then you want to install Node.js on the Windows Subsystem for Linux (more specifically, WSL 2).
14+
If you prefer using Node.js in a Linux environment, find performance speed and system call compatibility important, want to run [Docker containers](/windows/wsl/tutorials/wsl-containers) that leverage Linux workspaces and avoid having to maintain both Linux and Windows build scripts, or just prefer using a Bash command line, then you want to install Node.js on the Windows Subsystem for Linux (more specifically, WSL 2).
1515

16-
Using Windows Subsystem for Linux (WSL), enables you to install your preferred Linux distribution (Ubuntu is our default) so that you can have consistency between your development environment (where you write code) and production environment (the server where your code is deployed).
16+
Using Windows Subsystem for Linux (WSL), might also enable you to install your preferred Linux distribution (Ubuntu is our default) so that you can have consistency between your development environment (where you write code) and production environment (the server where your code is deployed).
1717

1818
> [!NOTE]
1919
> If you are new to developing with Node.js and want to get up and running quickly so that you can learn, [install Node.js on Windows](./nodejs-on-windows.md). This recommendation also applies if you plan to use a Windows Server production environment.
@@ -39,6 +39,8 @@ Besides choosing whether to install on Windows or WSL, there are additional choi
3939
> [!IMPORTANT]
4040
> It is always recommended to remove any existing installations of Node.js or npm from your operating system before installing a version manager as the different types of installation can lead to strange and confusing conflicts. For example, the version of Node that can be installed with Ubuntu's `apt-get` command is currently outdated. For help with removing previous installations, see [How to remove nodejs from ubuntu](https://askubuntu.com/questions/786015/how-to-remove-nodejs-from-ubuntu-16-04).)
4141
42+
For the most current information on installing NVM, see [Installing and Updating in the NVM repo on GitHub](https://github.com/nvm-sh/nvm?tab=readme-ov-file#installing-and-updating).
43+
4244
1. Open your Ubuntu command line (or distribution of your choice).
4345
1. Install cURL (a tool used for downloading content from the internet in the command-line) with: `sudo apt-get install curl`
4446
1. Install nvm, with: `curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash`

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

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,6 @@ Yes. Windows supports two different environments for developing apps with Node.j
2121
- [Install a Node.js development environment on Windows](./nodejs-on-windows.md)
2222
- [Install a Node.js development environment on Windows Subsystem for Linux](./nodejs-on-wsl.md)
2323

24-
For help determining which environment to use, check out [Should I install on Windows or Windows Subsystem for Linux?](./windows-or-wsl.md)
25-
2624
## What can you do with NodeJS?
2725

2826
Node.js is primarily used for building fast and scalable web applications. It uses an event-driven, non-blocking I/O model, making it lightweight and efficient. It's a great framework for data-intensive real-time applications that run across distributed devices. Here are a few examples of what you might create with Node.js.
@@ -37,7 +35,6 @@ Node.js is primarily used for building fast and scalable web applications. It us
3735

3836
## Next steps
3937

40-
- [Should I install on Windows or Windows Subsystem for Linux (WSL)?](./windows-or-wsl.md)
4138
- [Install NodeJS on Windows](./nodejs-on-windows.md)
4239
- [Install NodeJS on WSL](./nodejs-on-wsl.md)
4340
- [Build JavaScript applications with Node.js](/training/paths/build-javascript-applications-nodejs/) learning path

hub/dev-environment/javascript/react-beginners-tutorial.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,9 +20,8 @@ If you're brand new to using React, this guide will help you to get started with
2020

2121
## Prerequisites
2222

23-
- Install React *([Should I install on Windows or Windows Subsystem for Linux](./windows-or-wsl.md))*
24-
- [Install React on Windows](./react-on-windows.md)
25-
- [Install React on Windows Subsystem for Linux](./react-on-wsl.md)
23+
- [Install React on Windows](./react-on-windows.md)
24+
- [Install React on Windows Subsystem for Linux](./react-on-wsl.md)
2625
- [Install VS Code](https://code.visualstudio.com/download). We recommend installing VS Code on Windows, regardless of whether you plan to use React on Windows or WSL.
2726

2827
## A few basic terms and concepts

hub/dev-environment/javascript/react-native-for-windows.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -96,6 +96,5 @@ You can create a Windows desktop app using React Native for Windows by following
9696
- [React Native for Windows docs](https://microsoft.github.io/react-native-windows/docs/getting-started)
9797
- [React Native docs](https://reactnative.dev/docs/getting-started)
9898
- [React docs](https://reactjs.org/)
99-
- [Should I install on Windows or Windows Subsystem for Linux (WSL)?](./windows-or-wsl.md)
10099
- [Install NodeJS on Windows](./nodejs-on-windows.md)
101100
- Try the [React learning path](/training/paths/react/)

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

Lines changed: 8 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,11 @@
11
---
22
title: Install React on Windows
3-
description: Install a React development environment on Windows 10.
3+
description: Install a React development environment on Windows.
44
author: mattwojo
55
ms.author: mattwoj
66
manager: jken
77
ms.topic: article
8-
keywords: React, React JS, install react on windows, install react with windows, react on windows
9-
ms.localizationpriority: medium
10-
ms.date: 04/13/2021
8+
ms.date: 03/01/2024
119
---
1210

1311
# Install React directly on Windows
@@ -18,19 +16,16 @@ We recommend following these instructions if you are new to React and just inter
1816

1917
For more general information about React, deciding between React (web apps), React Native (mobile apps), and React Native for Windows (desktop apps), see the [React overview](./react-overview.md).
2018

21-
## Prerequisites
22-
23-
- Install the latest version of Windows 10 (Version 1903+, Build 18362+) or Windows 11
24-
- [Install Windows Subsystem for Linux (WSL)](/windows/wsl/install-win10), including a Linux distribution (like Ubuntu) and make sure it is running in WSL 2 mode. You can check this by opening PowerShell and entering: `wsl -l -v`
25-
- [Install Node.js on WSL 2](./nodejs-on-wsl.md): These instructions use Node Version Manager (nvm) for installation, you will need a recent version of NodeJS to run create-react-app, as well as a recent version of Node Package Manager (npm). For exact version requirements, see the [Create React App website](https://reactjs.org/docs/create-a-new-react-app.html#create-react-app).
19+
> [!WARNING]
20+
> If you've previously installed `create-react-app` on your machine, globally or via `npm install -g create-react-app`, it is recommended to uninstall the package using `npm uninstall -g create-react-app` or `yarn global remove create-react-app` to ensure that `npx` always uses the latest version.
2621
2722
## Create your React app
2823

29-
To install the full React toolchain on WSL, we recommend using create-react-app:
24+
To install Create React App:
3025

3126
1. Open a terminal(Windows Command Prompt or PowerShell).
3227
2. Create a new project folder: `mkdir ReactProjects` and enter that directory: `cd ReactProjects`.
33-
3. Install React using create-react-app, a tool that installs all of the dependencies to build and run a full React.js application:
28+
3. Install create-react-app, a tool that installs all of the dependencies to build and run a full React.js application:
3429

3530
```powershell
3631
npx create-react-app my-app
@@ -54,11 +49,11 @@ To install the full React toolchain on WSL, we recommend using create-react-app:
5449
5550
6. When you're ready to deploy your web app to production, running `npm run build` will create a build of your app in the "build" folder. You can learn more in the [Create React App User Guide](https://create-react-app.dev/docs/deployment).
5651
52+
Learn more in the [Create React App repo on GitHub](https://github.com/facebook/create-react-app). You can also find or file issues here if something doesn't work or ask questions in the GitHub Discussions tab of the repo.
53+
5754
## Additional resources
5855
5956
- [React docs](https://reactjs.org/)
60-
- [Create React App docs](https://create-react-app.dev/docs/getting-started)
61-
- [Should I install on Windows or Windows Subsystem for Linux (WSL)?](./windows-or-wsl.md)
6257
- [Install Next.js](./nextjs-on-wsl.md)
6358
- [Install Gatsby](./gatsby-on-wsl.md)
6459
- [Install React Native for Windows](https://microsoft.github.io/react-native-windows/docs/getting-started)

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

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,6 @@ Since React is a JavaScript library that is, in its most basic form, just a coll
6666

6767
- [React docs](https://reactjs.org/)
6868
- [Create React App docs](https://create-react-app.dev/docs/getting-started)
69-
- [Should I install on Windows or Windows Subsystem for Linux (WSL)?](./windows-or-wsl.md)
7069
- [Install Next.js](./nextjs-on-wsl.md)
7170
- [Install Gatsby](./gatsby-on-wsl.md)
7271
- [Install React Native for Windows](https://microsoft.github.io/react-native-windows/docs/getting-started)

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

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -25,8 +25,6 @@ Yes. Windows supports two different environments for developing React apps:
2525
- [Install a React development environment on Windows](./react-on-windows.md)
2626
- [Install a React development environment on Windows Subsystem for Linux](./react-on-wsl.md)
2727

28-
For help determining which environment to use, check out [Should I install on Windows or Windows Subsystem for Linux?](./windows-or-wsl.md)
29-
3028
## What can you do with React?
3129

3230
Windows supports a wide range of scenarios for React developers, including:
@@ -62,7 +60,7 @@ While writing a simple React component in a plain text editor is a good introduc
6260

6361
Together, the suite of frameworks that help you create, build, and deploy your app are called a toolchain. An easy toolchain to get started with is [create-react-app](https://create-react-app.dev), which generates a simple one-page app for you. The only setup required to use **create-react-app** is Node.js.
6462

65-
- For Windows development, follow the instructions to [install Node.js on WSL](./nodejs-on-wsl.md) or [install Node.js on Windows](./nodejs-on-windows.md). For help deciding which to use, check out the article: [Should I install on Windows or Windows Subsystem for Linux?](./windows-or-wsl.md).
63+
- For Windows development, follow the instructions to [install Node.js on WSL](./nodejs-on-wsl.md) or [install Node.js on Windows](./nodejs-on-windows.md).
6664

6765
### React Native component directory
6866

hub/dev-environment/javascript/vue-beginners-tutorial.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ If you're brand new to using Vue.js, this guide will help you to get started wit
1919

2020
## Prerequisites
2121

22-
- You must first install Vue.js on [Windows](./vue-on-windows.md) or on [Windows Subsystem for Linux](./vue-on-wsl.md). Not sure which to use, generally we recommend beginners install on Windows to learn, but professionals install on WSL, see [Should I install Node.js on Windows or Windows Subsystem for Linux](./windows-or-wsl.md).
22+
- You must first install Vue.js on [Windows](./vue-on-windows.md) or on [Windows Subsystem for Linux](./vue-on-wsl.md).
2323

2424
## Try NodeJS with Visual Studio Code
2525

0 commit comments

Comments
 (0)