Skip to content

Conversation

@Nitin-100
Copy link
Contributor

@Nitin-100 Nitin-100 commented Dec 18, 2025

Description

  • Add step to check peer dependencies before upgrading
  • Add step to update react-native to match RNW peer dependency
  • Add step to update react-native-windows
  • Add step to update @react-native/metro-config dev dependency
  • Clarify importance of --overwrite flag for metro.config.js
  • Add Troubleshooting section for common upgrade issues:
    • Metro API mismatch error
    • ERR_UNSUPPORTED_ESM_URL_SCHEME on Windows

These steps were discovered during testing migration from 0.80 to 0.81 where Metro would fail without the @react-native/metro-config update.

Why

Failure of upgrading apps from 0.80 to 0.81

Microsoft Reviewers: Open in CodeFlow

@Nitin-100 Nitin-100 requested a review from a team as a code owner December 18, 2025 07:37
- Add step to check peer dependencies before upgrading
- Add step to update react-native to match RNW peer dependency
- Add step to update react-native-windows
- Add step to update @react-native/metro-config dev dependency

These steps were discovered during testing migration from 0.80 to 0.81
where Metro would fail without the @react-native/metro-config update.
@Nitin-100 Nitin-100 force-pushed the fix/upgrade-app-docs-missing-steps branch from f1b7a14 to 54bf086 Compare December 18, 2025 07:39
Copy link
Contributor

@vineethkuttan vineethkuttan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@Nitin-100 Nitin-100 merged commit f0859cc into main Jan 2, 2026
21 checks passed
@vineethkuttan vineethkuttan deleted the fix/upgrade-app-docs-missing-steps branch January 2, 2026 11:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants