Appearance
Submit your MiniApp
To get your Mini App listed in MiniPay's Discover page, submit it using our submission form.
Submission Form
Listing fields
When you submit, you will be asked for the following. Prepare these before filling the form:
| Field | Description |
|---|---|
| App name | Clear, descriptive name for your Mini App. |
| Tagline | Brief description (1–2 sentences). |
| Publisher | Your name or organization. |
| Support URL | In-app support link (visible inside the Mini App). Ideally Telegram, WhatsApp, email, or a web support portal. |
| Terms of Service | Accessible link within the app to your Terms of Service. |
| Privacy Policy | Accessible link within the app to your Privacy Policy. |
| Category | One of: games, social, finance, utility, productivity, health-fitness, news-media, music, shopping, education, developer-tools, entertainment, art-creativity, rewards, sports. |
| App URL (linkUrl) | The HTTPS URL where your Mini App is hosted. Must be publicly accessible over HTTPS. |
| Icon | High-quality icon (recommended: 512×512px). |
There is no manifest or config file in your repo—listing is done only through this submission process.
Submission requirements
Before submitting, ensure your Mini App meets these requirements:
Technical requirements
- ✅ Auto-connects to wallet - No connect button, connection happens automatically
- ✅ HTTPS enabled - Your app must be served over HTTPS
- ✅ Mobile-optimized - Responsive design that works on mobile devices (minimum viewport 360×720; see UI & container)
- ✅ Works on Celo networks - Supports Celo Mainnet and/or Celo Sepolia testnet
- ✅ Error handling - Graceful error handling for wallet operations
- ✅ Performance - Provide a PageSpeed Insights score for your production URL. High performance is a prerequisite for listing.
- ✅ Network manifest - Provide a full manifest of all URLs, subdomains, and origins your app uses (including external links for JS, CSS, and APIs).
Content requirements
Use the listing fields above as a checklist. Ensure your app name, tagline, icon, category, support URL, and publisher are accurate and complete.
Branding and legal
- Clear ownership - Your app must clearly display its name and logo. It must be obvious to the user that the service is operated by your entity and not by MiniPay.
- Terms of Service and Privacy Policy - Provide accessible in-app links to your Terms of Service and Privacy Policy.
Smart contracts (if your app uses them)
- Contract verification - All contract source code must be published and verified on Celoscan.
- Sample transactions - Provide links to sample transactions for every user-facing contract method. See Interacting with smart contracts for guidance.
Support and SLA
- Dedicated support - Provide an in-app support link (see listing fields); ideally Telegram, WhatsApp, email, or a web support portal.
- Critical issues - You must fix reported critical issues within 24 hours, or the listing may be temporarily disabled.
Best practices
- Test thoroughly - Test your app in MiniPay's Developer Mode before submitting
- Clear value proposition - Users should understand what your app does immediately
- Fast loading - Optimize for quick load times
- User-friendly - Intuitive interface and clear error messages
What Happens After Submission
- Review Process - Our team reviews your submission
- Testing - We test your app in MiniPay
- Feedback - If needed, we'll provide feedback for improvements
- Approval - Once approved, your app will be listed in MiniPay's Discover page
Common Rejection Reasons
- App doesn't auto-connect to wallet
- App not served over HTTPS
- Poor mobile experience
- Missing error handling
- App doesn't work on Celo networks
- Incomplete or unclear submission information
Tips for Successful Submission
- Follow guidelines - Read and follow all documentation guidelines
- Test in MiniPay - Use Developer Mode to test your app thoroughly
- Provide clear information - Fill out all submission fields completely
- Include support - Provide a support URL or contact information
- Polish your app - Ensure it's production-ready before submitting
Need Help?
If you have questions about the submission process or need help with your Mini App:
- Check our FAQ
- Review our best practices guide
- See our example implementations