GoodBuild

Blog · MiniPay apps

How to Test Your App Inside MiniPay (Developer Mode)

You can load your own web app inside MiniPay using its developer settings, which is the only reliable way to see how it behaves in the wallet people will use.

· 2 min read

What you need

  • The MiniPay app on a phone.
  • A public https address for your app. A GoodBuild published app already has one, like your-app.goodbuildit.xyz.
  • A little test CELO and a test stablecoin on Celo Sepolia if your app sends money.

Steps

  1. In MiniPay, open Settings, then Developer Settings.
  2. Turn on Developer Mode. To use the test network, also turn on Use Testnet.
  3. Choose Load Test Page, type your app's https address and tap Go.
  4. Your app opens inside the wallet. Try the main action end to end.

What to look for

  • Does the wallet connect with no list of wallets?
  • Is every button reachable with a thumb, and is the text readable?
  • Does the amount shown before signing match the amount sent?
  • What happens when you reject the transaction?
  • Does the page load fast on a weak connection?

Working on your computer

If you are running the app on your own machine, you need an https tunnel so the phone can reach it. Tools like ngrok do this. If you use GoodBuild, publishing gives you the address directly. Update the app, publish again and reload the page in MiniPay.

An honest note

MiniPay's menus change between versions, so if a label differs, look for the developer or test options. GoodBuild's published apps are built to auto-connect in MiniPay, and this is exactly the check that confirms it for your app.