Edit

System Requirements

You can run React Native for Windows apps only on:

• all Windows 11 devices
• Windows 10 devices with Windows version: 10.0.16299.0 (aka 1709, aka Redstone 3, aka Fall Creators Update) or higher Some features may not work on all versions. See Windows 10 Compatibility for version support details.

To develop React-Native for Windows apps, you need to install several dependencies.

Install the development dependencies

To check or install dependencies, run the script rnw-dependencies.ps1 in an elevated PowerShell window.

Run this command: Start an elevated PowerShell window and run:

Set-ExecutionPolicy Unrestricted -Scope Process -Force;
iex (New-Object System.Net.WebClient).DownloadString('https://aka.ms/rnw-vs2019-deps.ps1')

Manual setup instructions

The recommended way is to use the script above as the information in this manual section is likely to get out of date

Alternatively, you can setup your environment manually:

• Ensure Developer Mode is turned ON in Windows Settings App.
• It is highly recommended to update the Windows system.
• Install a recent version of Visual Studio 2019 with the following options checked:
  • Workloads
    • Node.js development, or one of the following alternatives:
      • Install from Individual Components:
        • Development activities
          • Node.js development support
      • Install Node.js separately, see below for some options
    • .NET Desktop development
    • Desktop development with C++
    • Universal Windows Platform development
      • Include C++ (v142) Universal Windows Platform tools (under 'Optional')
      • Older Windows 10 SDK version may be needed at this point.
• Ensure that long path support is enabled.

Options to install Node.js separately:

• Using Chocolatey (React Native recommended). To use chocolatey, from an elevated Command Prompt, run:

choco install nodejs-lts

• Using another package manager such as Scoop or Node Version Switcher (nvs)
• Directly from Node.js

Optional steps that are highly recommended:

• Install Chrome (needed for JS debugging)
• Install Yarn (required to contribute to react-native-windows)
• Install git using a method such as:
  • Using a package manager such as Chocolatey or Scoop
  • Install git for Windows
  • Install GitHub Desktop

Troubleshooting

• If after running the app, the packager does not update (or) app does not show React Native content - close the packager command prompt window and the app, make sure browser is open, run yarn start and run the app from Visual Studio again.
• If you get a red error box in your UWP app window with the error message : ERROR: Instance failed to start. A connection with the server cannot be established, make sure you have the packager running using yarn start and run the app again.