feat: Make react hook and widget MiniKit compatible

[Takaros999]

Seamless DevEx to migrate from Minikit to IDKit, plug and play the widget or hook:

Hook usage:

  const { open, result, isInWorldApp, connectorURI } = useIDKitRequest({
    app_id: "app_xxx",               
    action: "verify",  
    // ... 
  });

  // connectorURI is null in World App (no QR needed)
  // isInWorldApp is true when running inside World App

Widget usage:

  // Works in both contexts with zero config changes
  <IDKitRequestWidget
    open={open}
    onOpenChange={setOpen}
    handleVerify={(result) => { /* called in both contexts */ }}
    onSuccess={(result) => { /* called in both contexts */ }}
    onError={(code) => { /* called in both contexts */ }}
    {...config}
  />

ScreenRecording_03-13-2026.11-32-24_1.MP4

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
idkit-js-example	Ready	Preview, Comment	Mar 13, 2026 11:41pm

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6e47735f63

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[Takaros999]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ae72ab6b0a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[Takaros999]

i needed this to make minikit work :/

[Takaros999]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c7595ed4ac

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Prevent duplicate handleVerify calls in World App mode

In World App mode this effect re-runs whenever the handleVerify prop gets a new function identity, so a parent re-render during isHostVerifying can invoke host verification multiple times for the same flow.result. Because the cancelled flag only suppresses setHostVerifyResult and does not cancel the already-started promise, duplicate backend side effects (e.g., repeated verification submissions) are still triggered; this is especially likely when integrators pass inline callbacks as shown in the widget usage examples.

Useful? React with 👍 / 👎.