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

Open
#14,432 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Area: CLI Area: Fabric Developer First Experience enhancement help wanted New Architecture Workstream: Developer Experience
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
  1. Create a new RNW app with the New Arch template
  2. 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.