docs: add IDKit invite-code mode page

docs.json

@@ -63,6 +63,7 @@
             "group": "IDKit",
             "pages": [
               "world-id/idkit/integrate",
+              "world-id/idkit/verification-flows",
               "world-id/idkit/credentials",
               "world-id/idkit/signatures",
               "world-id/idkit/build-with-llms",
@@ -773,6 +774,10 @@
       "source": "/world-id/id/idkit-v4-preview",
       "destination": "/world-id/idkit/integrate"
     },
+    {
+      "source": "/world-id/idkit/invite-code",
+      "destination": "/world-id/idkit/verification-flows#with-invite-code-mode"
+    },
     {
       "source": "/world-id/credentials/presets",
       "destination": "/world-id/credentials#legacy-presets"

world-id/idkit/integrate.mdx

@@ -116,6 +116,13 @@ func handleRPSignature(w http.ResponseWriter, r *http.Request) {
 </Warning>
 
 
+<Note>
+  The steps below cover the standard request flow. Depending on whether the user
+  already has World App and the credential you're requesting, they may be taken
+  through a different experience. See [Verification flows](/world-id/idkit/verification-flows)
+  for details.
+</Note>
+
 # Step 4: Generate the connect URL and collect proof
 You can test during development using the [simulator](https://simulator.worldcoin.org/) and setting `environment` to `"staging"`.
 

world-id/idkit/javascript.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Javascript"
+title: "JavaScript"
 description: "Reference for `@worldcoin/idkit-core`"
 "og:image": "https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png"
 "twitter:image": "https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png"
@@ -27,7 +27,8 @@ yarn add @worldcoin/idkit-core
 ## Entry points
 
 - `IDKit.request(config)` for uniqueness proofs
-- `orbLegacy`, `secureDocumentLegacy`, `documentLegacy` for presets
+- `IDKit.requestWithInviteCode(config)` for invite-code mode
+- `orbLegacy`, `secureDocumentLegacy`, `documentLegacy`, `selfieCheckLegacy` for presets
 
 Each entry point returns a builder. Finalize it with `.preset(...)`.
 
@@ -102,6 +103,64 @@ if (!completion.success) {
   Outside World App, `connectorURI` is the URL you render as a QR code.
 </Note>
 
+## Invite-code mode
+
+Use `IDKit.requestWithInviteCode(config)` to display a short code instead of a QR. Validation, the returned `Status` shape, and the poll loop are identical to `IDKit.request`. See [Invite-code mode](/world-id/idkit/verification-flows#with-invite-code-mode) for when to use it.
+
+```ts
+import { IDKit, selfieCheckLegacy } from "@worldcoin/idkit-core";
+
+const request = await IDKit.requestWithInviteCode({
+  app_id: "app_xxxxx",
+  action: "my-action",
+  rp_context,
+  allow_legacy_proofs: true,
+}).preset(selfieCheckLegacy({ signal: "user-123" }));
+
+const code = request.code;             // 6-character canonical form
+const expiresAt = request.expiresAt;   // Unix seconds
+const completion = await request.pollUntilCompletion();
+```
+
+`IDKitInviteCodeRequest` exposes:
+
+- `code`
+- `expiresAt`
+- `requestId`
+- `pollOnce()`
+- `pollUntilCompletion({ pollInterval, timeout })`
+
+### Migrating from QR / connect-URL
+
+```ts
+// Before — QR / connect-URL flow
+const request = await IDKit.request({
+  app_id: "app_xxxxx",
+  action: "my-action",
+  rp_context,
+  allow_legacy_proofs: true,
+}).preset(orbLegacy({ signal: "user-123" }));
+
+const connectorURI = request.connectorURI;   // render as QR
+const completion = await request.pollUntilCompletion();
+```
+
+```ts
+// After — invite-code mode
+const request = await IDKit.requestWithInviteCode({
+  app_id: "app_xxxxx",
+  action: "my-action",
+  rp_context,
+  allow_legacy_proofs: true,
+}).preset(selfieCheckLegacy({ signal: "user-123" }));
+
+const code = request.code;                   // display to user
+const expiresAt = request.expiresAt;         // drive a countdown
+const completion = await request.pollUntilCompletion();
+```
+
+The config object is unchanged. Replace `connectorURI` (QR) with `code` and `expiresAt` in your UI. Polling, proof verification, and nullifier storage stay the same.
+
 ## Server-side helpers
 
 Use subpath exports on your backend:

world-id/idkit/onchain-verification.mdx

@@ -1,5 +1,5 @@
 ---
-title: "On-chain verification"
+title: "On-chain Verification"
 description: "Verify World ID proofs directly in Solidity for web3-native flows."
 "og:image": "https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png"
 "twitter:image": "https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png"

world-id/idkit/react.mdx

@@ -116,6 +116,77 @@ Hook result fields:
 - `result`
 - `errorCode`
 
+## Invite-code mode
+
+For invite-code flows, use `IDKitInviteCodeRequestWidget` (controlled) or `useIDKitInviteCodeRequest` (headless). Config matches `IDKitRequestWidget` / `useIDKitRequest` — invite-code mode adds no new required fields. See [Invite-code mode](/world-id/idkit/verification-flows#with-invite-code-mode) for when to use it.
+
+```tsx
+import { IDKitInviteCodeRequestWidget, selfieCheckLegacy } from "@worldcoin/idkit";
+
+<IDKitInviteCodeRequestWidget
+  open={open}
+  onOpenChange={setOpen}
+  app_id="app_xxxxx"
+  action="my-action"
+  rp_context={rpContext}
+  allow_legacy_proofs={true}
+  preset={selfieCheckLegacy({ signal: "user-123" })}
+  handleVerify={async (result) => { /* ... */ }}
+  onSuccess={() => { /* ... */ }}
+/>;
+```
+
+`useIDKitInviteCodeRequest` result fields (sibling of `useIDKitRequest`'s):
+
+- `open()`
+- `reset()`
+- `isAwaitingUserConnection`
+- `isAwaitingUserConfirmation`
+- `isSuccess`
+- `isError`
+- `code`
+- `codeExpiresAt`
+- `result`
+- `errorCode`
+
+### Migrating from QR / connect-URL
+
+```tsx
+// Before — QR / connect-URL widget
+import { IDKitRequestWidget, orbLegacy } from "@worldcoin/idkit";
+
+<IDKitRequestWidget
+  open={open}
+  onOpenChange={setOpen}
+  app_id="app_xxxxx"
+  action="my-action"
+  rp_context={rpContext}
+  allow_legacy_proofs={true}
+  preset={orbLegacy({ signal: "user-123" })}
+  handleVerify={handleVerify}
+  onSuccess={onSuccess}
+/>;
+```
+
+```tsx
+// After — invite-code widget
+import { IDKitInviteCodeRequestWidget, selfieCheckLegacy } from "@worldcoin/idkit";
+
+<IDKitInviteCodeRequestWidget
+  open={open}
+  onOpenChange={setOpen}
+  app_id="app_xxxxx"
+  action="my-action"
+  rp_context={rpContext}
+  allow_legacy_proofs={true}
+  preset={selfieCheckLegacy({ signal: "user-123" })}
+  handleVerify={handleVerify}
+  onSuccess={onSuccess}
+/>;
+```
+
+Swap the component and preset. Props, callbacks, and backend verification stay the same. The headless equivalent is `useIDKitInviteCodeRequest` in place of `useIDKitRequest`.
+
 ## Presets
 
 React hooks/widgets take `preset` directly in config.

world-id/idkit/swift.mdx

@@ -75,3 +75,47 @@ case .failure(let error):
   print(error)
 }
 ```
+
+## Invite-code mode
+
+Use `presetWithInviteCode(_:)` on the builder to return an `IDKitInviteCodeRequest` instead of `IDKitRequest`. The polling surface is identical. See [Invite-code mode](/world-id/idkit/verification-flows#with-invite-code-mode) for when to use it.
+
+```swift
+let request = try IDKit.request(config: config)
+  .presetWithInviteCode(selfieCheckLegacy(signal: "user-123"))
+
+let code = request.code              // 6-character canonical form
+let expiresAt = request.expiresAt    // Date
+let completion = await request.pollUntilCompletion()
+```
+
+### Migrating from QR / connect-URL
+
+```swift
+// Before — QR / connect-URL flow
+let request = try IDKit.request(config: config)
+  .preset(orbLegacy(signal: "user-123"))
+
+let connectURL = request.connectorURL        // render as QR
+let completion = await request.pollUntilCompletion()
+```
+
+```swift
+// After — invite-code mode
+let request = try IDKit.request(config: config)
+  .presetWithInviteCode(selfieCheckLegacy(signal: "user-123"))
+
+let code = request.code                      // display to user
+let expiresAt = request.expiresAt            // drive a countdown
+let completion = await request.pollUntilCompletion()
+```
+
+The config object is unchanged. Replace `connectorURL` (QR) with `code` and `expiresAt` in your UI. Polling, proof verification, and nullifier storage stay the same.
+
+`IDKitInviteCodeRequest` exposes:
+
+- `code: String`
+- `expiresAt: Date`
+- `requestID: UUID`
+- `pollStatusOnce() async -> IDKitStatus`
+- `pollUntilCompletion(options:) async -> IDKitCompletionResult`