Skip to content

docs(world-id): add Selfie Check Sandbox testing guide#142

Open
noamtfh wants to merge 3 commits into
docs/sandbox-environmentfrom
docs/sandbox-selfie-check-testing
Open

docs(world-id): add Selfie Check Sandbox testing guide#142
noamtfh wants to merge 3 commits into
docs/sandbox-environmentfrom
docs/sandbox-selfie-check-testing

Conversation

@noamtfh

@noamtfh noamtfh commented Jul 17, 2026

Copy link
Copy Markdown

Summary

  • Stacked on docs(world-id): add Sandbox environment guide #141 (Sandbox environment docs) — targets that branch, not main.
  • Adds world-id/sandbox/testing-selfie-check.mdx: coverage matrix (entry surface x Hot/Cold/Semi-cold state), critical user journeys, and known limitations (iOS Semi-cold gap, invite-code handling differences) for testing Selfie Check end-to-end in Sandbox. Adapted from the internal Reddit Sandbox testing scope doc, generalized for any relying party (no partner-specific references).
  • Cross-links added:
    • world-id/sandbox/sandbox-access.mdx "Next step" now links here instead of the placeholder "(covered in a separate guide)".
    • world-id/credentials/11.mdx (Selfie Check) "Next steps".
    • world-id/idkit/credentials.mdx "## Selfie Check" section.
    • Registered under the "Sandbox" nav group in docs.json.

Why draft

Same reason as #141 — Sandbox Milestone 1 isn't finished (eng deadline 2026-07-21, e2e round-trip currently blocked). Also stacked on a draft PR, so this shouldn't merge before #141 does.

Test plan

🤖 Generated with Claude Code

@noamtfh
noamtfh changed the base branch from docs/sandbox-environment to main July 17, 2026 23:19
@noamtfh
noamtfh changed the base branch from main to docs/sandbox-environment July 17, 2026 23:22
@noamtfh
noamtfh changed the base branch from docs/sandbox-environment to main July 17, 2026 23:22
@mintlify

mintlify Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
world 🟢 Ready View Preview Jul 17, 2026, 11:24 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@noamtfh
noamtfh changed the base branch from main to docs/sandbox-environment July 17, 2026 23:26
@mintlify

mintlify Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
world 🟡 Building Jul 17, 2026, 11:23 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@noamtfh
noamtfh marked this pull request as ready for review July 20, 2026 16:59
@noamtfh
noamtfh force-pushed the docs/sandbox-environment branch from 616ca4c to c86318e Compare July 20, 2026 17:45
noamtfh and others added 2 commits July 20, 2026 10:45
Add a testing guide covering coverage (entry surface x user state),
critical user journeys, and known limitations for testing Selfie Check
end-to-end in Sandbox. Cross-link it from the Selfie Check credential
page and the IDKit credentials integration guide.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Comment on lines +52 to +56
- **Sandbox apps aren't published to the app stores.** As with other Sandbox testing,
install deep links won't route to a store listing the way they do in production —
see [How to get access](/world-id/sandbox/sandbox-access#things-to-know). This means
the Cold and Semi-cold journeys above can't be exercised exactly as they will be once
the app is on the App Store or Play Store.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

We should have a dedicated "Testing the Cold Flow" that walks them through how to best test the cold flow.

We want to give them confidence that they can test the cold flow, not emphasize too much that it's not a valid atest.

Comment on lines +58 to +60
Android today. On iOS, if the user taps "Sign in" instead of "Sign up" mid-flow,
there's no path to add the invite code — they have to restart from a fresh QR or deep
link. Expect iOS Semi-cold to behave differently from Android until this is closed.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

We don't need to document this, we need to fix it :)

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
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.

2 participants