Skip to main content

​
Manifest Configuration

Configure your MiniApp’s frame manifest with explicit asset byte caps and metadata for discovery.

​
Required fields

{
  "frame": {
    "name": "Your App",
    "subtitle": "Short value prop",
    "iconUrl": "https://.../icon-512.png", // <= 60 KB
    "splashImageUrl": "https://.../splash-200.png", // <= 40 KB
    "splashBackgroundColor": "#0B0B0C",
    "heroImageUrl": "https://.../hero-1200x628.jpg", // <= 250 KB
    "screenshotUrls": ["https://.../shot1.jpg"], // up to 3, <= 500 KB each
    "primaryCategory": "games",
    "noindex": true
  }
}

​
Asset caps (unified)

AssetDimensionsMax size
Icon512×51260 KB
Splash200×20040 KB
Hero1200×628250 KB
Open Graph1200×630250 KB
Screenshotsvariable500 KB each (max 3)
See also: Asset Specifications

​
Validation

# Validate manifest and assets
mini-kit doctor /path/to/your/app

​
Tips

  • Host images on a CDN with long cache headers
  • Serve WebP/AVIF with fallbacks; downscale to target bytes
  • Keep noindex: true until you’re ready to launch