microsoft / microsoft/react-native-windows
New Architecture application appears as blank white app when launching on certain versions of RNW: Better dev ex around this class of errors
Nobody has claimed this yet.
- Dominant language
- C++
- Stars
- 17.3k
- Forks
- 1.2k
- Avg merge
- 1d 13h
- Merged PRs (30d)
- 33
Description
Problem Description
There have been several instances of a fresh New Architecture app being launched and deployed without any build errors, but then displaying a blank white screen. The JS bundle loads correctly, and the solution has no errors, so it is very difficult to debug the reason why the app content is not being displayed.
Link to instance of issue: https://github.com/microsoft/react-native-windows/issues/14370
A common cause of this error is when the RN and RNW versions being used by the app are not the same major version (i.e using 0.77.X RNW version with 0.78.X RN version). In order to fix this, the react-native and react-native-windows dependencies should be on the same major version.
Steps To Reproduce
- Create a new RNW app with the New Arch template
- Build and launch
Expected Results
App displays content successfully
CLI version
npx @react-native-community/cli -v
Environment
npx @react-native-community/cli info
Community Modules
No response
Target Platform Version
None
Target Device(s)
No response
Visual Studio Version
None
Build Configuration
None
Snack, code example, screenshot, or link to a repository
No response
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reproducing the blank-screen behavior with a fresh New Architecture app, following the steps in this issue and comparing the RN and RNW major versions. Review the related issue at https://github.com/microsoft/react-native-windows/issues/14370. Done should include a clear diagnostic or error path for version mismatches instead of an unexplained blank app.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- react-native
- Domain
- developer-experience
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 30/100