Mini Apps

Appearance

Quick Start ​

The fastest way to build a MiniPay Mini App is with Celopedia — a comprehensive Celo knowledge skill for AI coding assistants (Claude Code, Cursor, Codex, and similar). Install it once and your assistant can scaffold a Mini App, wire up wallet detection and stablecoin payments, and answer ecosystem questions inline.

Prefer to wire things up by hand? See Setup with React for the manual Vite + Wagmi walkthrough.

Prerequisites ​

  • Node.js 18+
  • An AI coding assistant that supports skills (Claude Code, Cursor, Codex, etc.)
  • Familiarity with React / TypeScript

Step 1: Install Celopedia ​

bash
npx skills add celo-org/celopedia-skills

That's it. The skill auto-activates inside your assistant whenever you describe a Celo or MiniPay task. Full reference and topic catalogue: celopedia.celo.org.

Step 2: Scaffold your Mini App ​

In your AI assistant, describe what you want — for example:

Create a new MiniPay Mini App that lets users send USDm to a contact. Use Next.js and Wagmi.

Celopedia bundles MiniPay-specific guidance — Mini App templates, wallet detection, auto-connect, stablecoin payment flows (USDm, USDC, USDT), fee abstraction (CIP-64), ngrok testing, and a live Mini Apps discovery snapshot — so your assistant can scaffold a project (often via Celo Composer) with:

  • Injected connector targeting Celo Mainnet (42220) + Celo Sepolia (11142220)
  • Auto-connect on load (no "Connect wallet" button — required by MiniPay)
  • Stablecoin transfer scaffolding using viem / wagmi

No manual config snippets to copy. If you'd rather see exactly what gets wired up, Setup with React walks through it by hand.

See also: Celo Agent Skills docs · celo-org/agent-skills repo · Celo Composer.

Step 3: Test in MiniPay ​

Expose your dev server with ngrok, enable Developer Mode in MiniPay, and use Load test page to enter your URL. Full instructions: Test in MiniPay.

Step 4: Submit your Mini App ​

When your app is production-ready, list it in MiniPay's Discover page via the submission form.

Next: Test in MiniPay to load your app in the wallet, or Setup with React if you want to see the manual setup the skills generate for you. For deeper guides: Wallet connection, Retrieve balance, Send transaction.