{
  "schema_version": "intent.v1",
  "slug": "connect-wallets-to-my-app",
  "title": "connect wallets to my app",
  "audience": "builder",
  "prompt": "I need users to connect their existing wallets to my dapp (multi-wallet, multi-chain) with good UX",
  "maps_to": [
    "wallet connection",
    "walletconnect",
    "appkit",
    "connect wallet",
    "wallet onboarding",
    "wallet auth"
  ],
  "stack": [
    {
      "slug": "reown",
      "role": "wallet_and_identity",
      "reason": "Use Reown AppKit (formerly WalletConnect) as the standard external-wallet connection layer across wallets and chains, with session and auth handling."
    },
    {
      "slug": "privy",
      "role": "wallet_and_identity",
      "reason": "Add Privy if you also need embedded wallets or social login for users who don't bring their own wallet."
    },
    {
      "slug": "pimlico",
      "role": "transactions_and_paymasters",
      "reason": "Pair with Pimlico bundler/paymaster for gasless smart-account UX after the wallet connects."
    },
    {
      "slug": "base",
      "role": "settlement_or_execution",
      "reason": "Use Base as a low-cost EVM default for consumer apps."
    }
  ],
  "excluded_candidates": [
    {
      "slug": "fluidkey",
      "reason": "FluidKey solves stealth-address privacy for receiving funds, not general wallet connection; it is a complementary privacy layer rather than the connect-wallet layer this intent needs."
    }
  ],
  "risks": [
    "Connection requires a Reown (WalletConnect) project id and per-app chain/wallet configuration.",
    "Mobile deep-linking and session reconnection are common UX failure points; test across wallets.",
    "Embedded (Privy) vs external (Reown) wallet choice changes onboarding and recovery flows; decide deliberately."
  ],
  "next_steps": [
    "Create a Reown project and obtain a project id.",
    "Configure supported chains and the wallet list for the connect modal.",
    "Decide whether to offer embedded wallets (Privy) alongside external connection.",
    "Add fallback and reconnection handling for mobile and session expiry."
  ],
  "why": "Reown (AppKit, formerly WalletConnect) is the default for connecting users' existing wallets: it is the de facto standard, multi-wallet, and multi-chain. Privy is added when the app also needs embedded wallets or social login, Pimlico supplies gasless smart-account UX after connect, and Base is a low-cost execution default. FluidKey is excluded as a privacy layer rather than a connection layer.",
  "verified_at": "2026-06-16"
}