worldcoin/minikit-js/miniapp-to-web
Claude Code and agent skill by worldcoin/minikit-js
- community
Checking that the SKILL.md file is still in the repository.
Use this skill when you are asked to make a World App mini app also work as a standalone web app, or to add browser wallet support alongside MiniKit. This skill covers adding Wagmi as a fallback so MiniKit commands work both inside World App and in any browser. All transactions are World Chain only (chainId 480).
Install
npx vskill@latest install worldcoin/minikit-js/miniapp-to-webSKILL.md
Migrate Mini App to Standalone Web App
You are converting a World App mini app to also work in a regular browser. MiniKit commands auto-detect the environment — inside World App they use the native bridge, outside they fall back to Wagmi. Follow these steps in order.
Step 1 — Install dependencies
wagmi— wallet connection and transaction execution on web@tanstack/react-query— peer dependency of wagmisiwe— needed forwalletAuthSIWE message construction on web
Step 2 — Create Wagmi config
worldApp() handles World App, injected() handles browser wallets (MetaMask, etc).
Step 3 — Update providers
Wrap with WagmiProvider and QueryClientProvider, and pass wagmiConfig to MiniKitProvider:
MiniKitProvider calls setWagmiConfig(config) internally which registers the Wagmi fallback adapter. WagmiProvider and QueryClientProvider are needed for Wagmi hooks like useWaitForTransactionReceipt.
Step 4 — Auth works automatically
MiniKit.walletAuth() requires no code changes:
- World App: native SIWE flow via Smart Account (Safe)
- Web: connects via Wagmi connector, signs SIWE message
Backend verification handles both account types
verifySiweMessage from @worldcoin/minikit-js/siwe auto-detects:
- Smart Account (Safe): EIP-1271
isValidSignatureon-chain - EOA: ECDSA
recoverMessageAddress
No branching needed — it checks if the address has contract code and picks the right method.
Step 5 — Transactions work automatically
MiniKit.sendTransaction() requires no code changes. World Chain only (chainId 480).
- World App: native bridge, supports batching, returns
userOpHash - Web (single tx): sent directly via Wagmi wallet
- Web (multiple txs): executed sequentially — each requires wallet confirmation (not atomic)
Handle transaction receipts by environment
Step 6 — World ID needs no changes
World ID uses IDKit, which is independent of the wallet layer. It works the same everywhere.
Step 7 — Other commands need fallbacks
Commands without built-in Wagmi adapters (pay, shareContacts, sendHapticFeedback, etc.) need a fallback function for web:
Without a fallback, these throw CommandUnavailableError on web.
What has built-in Wagmi support
| Command | Wagmi fallback | Notes | |
|---|---|---|---|
walletAuth | Yes | SIWE via Wagmi connector | |
sendTransaction | Yes | Single or sequential on web | |
signMessage | Yes | personal_sign via Wagmi | |
signTypedData | Yes | EIP-712 via Wagmi | |
pay | No | Provide fallback | |
shareContacts | No | Provide fallback | |
verify (World ID) | N/A | Uses IDKit directly | |
| Everything else | No | Provide fallback |
Key differences between environments
| Aspect | World App | Web | |
|---|---|---|---|
| Account type | Smart Account (Safe) | EOA | |
| Transaction hash | userOpHash (UserOperation) | Standard tx hash | |
| Multi-tx | Native atomic batching | Sequential (not atomic) | |
| Gas | Sponsored | User pays | |
| Chain | World Chain (480) | World Chain (480) |
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/miniapp-to-web/SKILL.md
Popularity
- Repository stars
- 89
- Repository forks
- 76
- 7-day trend score
- 22
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 15 Sep 2026, a month ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/worldcoin/minikit-js/miniapp-to-web)