Back to docs
Recipe

Web App Manifest

Ship a PWA manifest so Meridian dashboards install natively on desktop and mobile with proper icons, theme colors, and display mode.

Overview

A web app manifest is a JSON file that tells the browser how your application should behave when installed. Meridian uses it to enable standalone mode, set the splash screen background, and define app icons at multiple resolutions.

Manifest structure

{
  "name": "Meridian",
  "short_name": "Meridian",
  "start_url": "/dashboard",
  "display": "standalone",
  "background_color": "#0A0612",
  "theme_color": "#8B5CF6",
  "icons": [
    {
      "src": "/icon-192.png",
      "sizes": "192x192",
      "type": "image/png"
    },
    {
      "src": "/icon-512.png",
      "sizes": "512x512",
      "type": "image/png"
    }
  ]
}

Next.js setup

Place manifest.json in the public/ directory. Next.js serves it automatically. Link it from your root layout:

<link rel="manifest" href="/manifest.json" />

Verification

Open Chrome DevTools → Application → Manifest. Confirm all fields resolve and icons load. Test the install prompt on a production HTTPS deployment — PWAs require a secure context.

Next: explore Service Worker caching for offline support.