Skip to content

docs: closing the wallet from recents is the fix, not tapping again - #178

Merged
ehsan6sha merged 1 commit into
mainfrom
docs/wallet-force-quit-is-the-fix
Sep 4, 2026
Merged

docs: closing the wallet from recents is the fix, not tapping again#178
ehsan6sha merged 1 commit into
mainfrom
docs/wallet-force-quit-is-the-fix

Conversation

@ehsan6sha

Copy link
Copy Markdown
Member

#177 reordered the stuck-wallet advice to lead with "tap Open wallet to approve again", on the theory — shipped alongside it in functionland/fxblox-web#33 — that a second tap opened the wallet a different way and would usually get past the splash screen.

Tested on a phone since: it does not. A warm MetaMask hangs on the retry exactly as it hangs on the first attempt. Only closing MetaMask from recents and then tapping clears it, which is what these pages said before #177, and what functionland/fxblox-web#35 puts back in the app's own hint.

What changes

  • FxBlox App Setup — the force-quit leads again, and the tip now says plainly that tapping without closing the wallet first returns you to the same stuck screen (the thing a user will otherwise try twice before giving up). It also says where the fault is: inside the wallet app, where a web page cannot reach.
  • Same page → Troubleshooting — the matching bullet.
  • Switch Chain Troubleshooting — the same correction in its MetaMask section.

What stays from #177

The "give the page a few seconds when you come back from your wallet" guidance is untouched everywhere it was added. That part is about our own reconnect on the way back, and it is still right.

Testing

npm run build passes; onBrokenLinks: "throw" still covers the anchors.

🤖 Generated with Claude Code

https://claude.ai/code/session_013BpqXrkEPA9odTyRdK5Mnx

#177 reordered the stuck-wallet advice to lead with "tap Open wallet to approve
again", on the theory -- shipped alongside it in functionland/fxblox-web#33 --
that a second tap opened the wallet a different way and would usually get past
the splash screen.

Tested on a phone since: it does not. A warm MetaMask hangs on the retry exactly
as it hangs on the first attempt. Only closing MetaMask from recents and then
tapping clears it, which is what these pages said before #177 and what
functionland/fxblox-web#35 puts back in the app's own hint.

So the force-quit leads again, and each place now says plainly that tapping
without closing the wallet first returns you to the same stuck screen -- the
thing a user will otherwise try twice before giving up. Also says where the fault
is: inside the wallet app, where a web page cannot reach.

The "give the page a few seconds when you come back" guidance from #177 is
untouched -- that part was about our own reconnect and is still right.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013BpqXrkEPA9odTyRdK5Mnx
@ehsan6sha
ehsan6sha merged commit b2d2559 into main Sep 4, 2026
1 check passed
@ehsan6sha
ehsan6sha deleted the docs/wallet-force-quit-is-the-fix branch September 4, 2026 15:18
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.

1 participant