Skip to content

Commit 48e1170

Browse files
authored
docs: fix Metro bundler startup instructions (#2795)
## Summary This PR fixes the misleading documentation in `getting-started.md` that incorrectly stated Metro bundler would open automatically when running `npx react-native run-macos`. As confirmed in issue #2208, Metro bundler must be started separately before running the app and this is expected behavior by design. Users following the current documentation were encountering the error "**_No script URL provided. Make sure the packager is running or you have embedded a JS bundle in your application bundle_"** because they expected Metro to start automatically. ## Changes - Updated the Quick Start section to include Metro bundler startup as the first step - Removed the incorrect statement: "A Metro bundler window will also open to serve your JavaScript code" - Clarified that Metro must be running in a separate terminal before the app can connect to it Fixes #2208
1 parent 709c4c3 commit 48e1170

1 file changed

Lines changed: 10 additions & 2 deletions

File tree

docsite/docs/getting-started.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,13 +39,21 @@ npx react-native-macos-init
3939

4040
### Quick Start
4141

42-
In your React Native macOS project directory, run:
42+
1. **Start the Metro bundler** in your React Native macOS project directory:
43+
44+
```bash
45+
npm run start
46+
```
47+
48+
Keep this terminal window open. The Metro bundler must be running for your app to load JavaScript code.
49+
50+
2. **Build and launch your app** in a separate terminal window:
4351

4452
```bash
4553
npx react-native run-macos
4654
```
4755

48-
This will build your app and launch it automatically. A Metro bundler window will also open to serve your JavaScript code.
56+
This will build your app and launch it automatically.
4957

5058
### Alternative Methods
5159

0 commit comments

Comments
 (0)