Overview and implementation guide for Mini Apps in Coinbase Wallet
Mini Apps are lightweight web applications that run natively within clients like Coinbase Wallet. Users instantly access mini apps without downloads, benefit from seamless wallet interactions, and discover apps directly in the social feed. This benefits app developers by creating viral loops for user acquisition and engagement.
A Mini App is composed of:
Your current web app works as-is
Simple wrapper component integration
Single farcaster.json configuration file
Deploy to any hosting platform (Vercel, Netlify, etc.)
No rebuilding, architectural changes, or complex integrations are required.
Changes Required: Two import lines and one wrapper component. All existing components remain unchanged.
Result: Functional Mini App with wallet integration, transaction capabilities, and social features.
Common Engineering Concerns
MiniKit Automated Solutions
Mini Apps require one configuration file located at /.well-known/farcaster.json
in your project root. This file instructs clients how to display your application.
Gaming and entertainment applications
Social networking and communication tools
DeFi, trading, and payment applications
Tools and productivity applications
Task management and organization tools
Development utilities
Creative and artistic applications
Domain ownership verification is required. Generate your manifest using:
iconUrl
200x200px PNG/JPG format
splashImageUrl
200x200px PNG/JPG (displayed during app loading)
heroImageUrl
1200x628px PNG/JPG (for featured placement)
screenshotUrls
App store screenshots in various sizes
The deployment process remains identical to standard web applications:
Build Application
npm run build
(standard process)
Add Configuration
public/.well-known/farcaster.json
Deploy
Use any hosting platform (Vercel, Netlify, custom servers)
Browser Testing
Functions as standard web application
Farcaster Testing
No special hosting, new infrastructure, or complex setup procedures required.
Do we need to rebuild our entire application?
No. Wrap your existing application in <MiniKitProvider>
. Implementation complete.
Will this break our current web application?
No. Mini Apps function in regular browsers. The same codebase works across all platforms.
Do we need blockchain expertise?
No. Integration complexity is similar to Stripe implementation.
What about user data and privacy?
Maintain current practices. You control data, backend systems, and privacy policies.
What is the performance impact?
Minimal impact. MiniKit SDK is approximately 50KB. Application performance remains unchanged.
We don't use React/Next.js. Is this compatible?
Yes. The Farcaster SDK supports Vue, Angular, Svelte, and any web framework.
View working implementation examples
MiniKit documentation and overview
Comprehensive guide to Mini Apps
Debugging MiniKit and Mini Apps
Validate and test your Mini App
Farcaster Mini Apps SDK documentation
OnchainKit components and guides