docs: add staging captcha workaround for Desktop #7305
+19
−1
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
First time contributor checklist:
Contributor checklist:
main
branchpnpm run ready
run passes successfully (more about tests here)Description
Adds a short hCaptcha workaround note to CONTRIBUTING.md → The staging environment.
Fixes #7304
What’s changed
Documents the current limitation where development/Electron builds do not capture the
signalcaptcha://…
callback automatically.Provides the exact command-line workaround:
pnpm start -- "signalcaptcha://signal-hcaptcha-short-XXXXXXXX"
so new contributors can unblock registration or relinking on staging immediately.
Value to users
Without this note, first-time builders are stuck on the phone number page and often assume the project is broken.
The added two-sentence tip saves at least 10-15 minutes of head-scratching and reduces duplicate support questions in Issues.
Test approach