Skip to content

fix: reload every app through the Metro websocket #685

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
janicduplessis merged 1 commit into from
Sep 11, 2026
Merged

fix: reload every app through the Metro websocket #685

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,9 +43,11 @@ stim logs --errors
stim stop
```

`stim reload [ios|android]` is a recovery or explicit restart command. Use it
after a failed first bundle load or when an error screen remains after a fix,
not after every JavaScript edit.
`stim reload [ios|android]` is a recovery command that reloads JavaScript in the
live app and never restarts it. Use it when an error screen remains after a fix,
not after every JavaScript edit. It also recovers an Android app whose first
bundle failed; an iOS app in that state never connects to Metro, so reload
cannot reach it.

Stim needs no project initialization. Runtime state stays under `~/.stim` by
default.
Expand Down
10 changes: 6 additions & 4 deletions packages/stim-cli/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -86,10 +86,12 @@ response; servers without capture use the build-complete marker. Run
expected screen separately.

`stim reload [ios|android]` requests a JavaScript reload in the live app on this
workspace's owned local device. Use it after a failed first bundle load, when
an error screen remains after a fix, or when you explicitly need an app
restart. It is not part of the normal workflow and does not build, install,
boot, or launch an app. The platform is optional when only one app is live.
workspace's owned local device. Use it when an error screen remains after a fix,
and on Android after a failed first bundle load. An iOS app whose first bundle
failed never connects to Metro, so reload cannot reach it. It reloads
JavaScript and never restarts the app. It is not part of the normal workflow
and does not build, install, boot, or launch an app. The platform is optional
when only one app is live.
Success confirms that the request was sent; Stim does not observe completion.
Verify the expected UI on the reported device and inspect `stim logs --errors`
before claiming recovery.
Expand Down
1 change: 0 additions & 1 deletion packages/stim-cli/src/__tests__/crash-diagnostics.test.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -626,7 +626,6 @@ test('live native collection requires the current launch and device claim, not a
deviceId: 'emulator-5556',
metroPort: null,
release: true,
deepLinkUrl: null,
launchedAt: new Date(since).toISOString(),
};
let reads = 0;
Expand Down
Loading
Loading