Appearance
What are Mini Apps?
Mini Apps are web applications that run inside MiniPay's in-app browser. Users open them from the MiniPay Discover page without leaving the wallet. Your app gets instant access to the user's wallet and the Celo network — no separate onboarding or extension required.
How Mini Apps run
When a user opens your Mini App from MiniPay:
- MiniPay loads your app's URL in its in-app browser (WebView).
- MiniPay injects an Ethereum provider at
window.ethereum. - Your app uses this provider (directly or via Wagmi/Viem) to read the wallet address, request signatures, and send transactions on Celo.
So: your app is a normal web app (React, Vite, etc.) that expects to run in a context where window.ethereum is already available. You do not ship a native binary or a special manifest — just a URL that MiniPay opens.
Key capabilities
| Capability | Description |
|---|---|
| Wallet access | Read connected address and chain ID; no "Connect" button — MiniPay connects automatically when the app loads. |
| Signing & transactions | Send stablecoins (USDm, USDC, USDT) and interact with smart contracts. |
| Celo networks | Celo Mainnet (Chain ID 42220) and Celo Sepolia testnet (Chain ID 11142220) are the only supported networks for Mini Apps. |
| Optional features | Phone number lookup (map phone to address), deeplinks, and custom RPC methods for MiniPay-specific behavior. |
What you need to build
- A public HTTPS URL that serves your web app (Vite, Next.js, etc.).
- Wagmi (or similar) configured with the injected connector and Celo + Celo Sepolia chains.
- Auto-connect on load—never show a "Connect wallet" button; connection must happen when the page loads.
- Mobile-friendly UI—most users are on phones; design for small viewports and touch.
Next steps
- Quick Start — Get a minimal Mini App running in a few steps.
- Project setup — Repo structure, config, and environment variables.
- Test in MiniPay — Load your app inside the wallet using Developer Mode.