ReactNative for Windows (current)
current subdirectory holds support for an existing React Native for Windows implementation built in C#. See vnext for details on the
vnext rewrite of React Native for Windows built in C++.
Status and roadmap
We anticipate that there will be increased activity in the overall repository related to the
vnext refactoring effort, but that overall effort allocated to the existing architecture will be minimized. See Opening Issues for details on how to open issues if you encounter bugs with the existing architecture.
We are working on releasing a
v0.58 and a subsequent
v0.59 for the existing architecture in order to ensure existing apps can continue to upgrade to match
react-native versions while the
vnext implementation is in progress. See releases for more information on
react-native-windows release strategy.
- You can run React Native for Windows UWP apps only on Windows 10 devices. This
currentimplementation supports Windows 10 SDK > 14393 and Windows 8.1.
- You can run React Native for Windows WPF applications using this
currentimplementation on Windows 7-10 so long as .NET 4.6 is installed on the end user's machine
- Download Visual Studio 2017 Community or Greater. (Visual Studio 2015 support has been deprecated.)
- You will need to start Visual Studio after it is installed to do some final setup before it can be used to build or run your React Native Windows application
Note: Development on React Native Windows itself currently requires Visual Studio 2017. It is not supported with VS Code, but we will gladly accept pull requests to enable a great developer experience in those environments.
See Getting Started Guide for React Native for Windows - current to begin developing apps using
React Native already has great documentation, and we're working to ensure the React Native Windows is part of that documentation story. Check out the React documentation for further details about the React API in general.
For information on parity status with Android and iOS, including details on implemented and missing components and modules, along with related issues for missing features from partial implementations, go here
Showing the Debug Menu
- On UWP, press Shift+F10 to open the debug menu.
- On WPF, press CTRL+D or CTRL+M to open the debug menu.
Extending React Native
- See Extending React Native for more general information on community modules and other extension capabilities.
- Read the guides on Native Modules for Windows and Native UI Components for Windows if you are interested in extending native functionality.
If you encounter a bug with the
current architecture, we would like to hear about it. Search the existing issues and try to make sure your problem doesn’t already exist before opening a new issue. It’s helpful if you include the version of Windows, React Native, React Native Windows plugin, and device family (i.e., desktop, Xbox, etc.) you’re using. Please include a stack trace and reduced repro case when appropriate, too.
Please continue to report issues as you encounter them, but be sure to use the correct template for issues related to the existing
See Contributing guidelines for how to setup your fork of the repo and start a PR to contribute to React Native Windows - current.