PWA web app manifest generator
Create a manifest.json for your Progressive Web App. Set your app name, icon paths and colors, then copy or download the JSON. The HTML snippets tab gives you the manifest link and theme-color tag to add to your pages.
The generator runs in your browser. You supply the icon files; it generates their manifest entries. Use the favicon checklist for other icon tags.
Icons
Checklist
Icons you typically need
- 192×192 and 512×512 PNG files for Chromium installation checks.
- A separate maskable icon with padding around the logo, so adaptive shapes don't crop it. Set its purpose to
maskable.
iOS quirks
- iOS supports manifest icons. If you also supply an
apple-touch-iconlink, it takes precedence on iOS. See WebKit's Home Screen guidance.
HTTPS
- Use HTTPS in production. You can test installation locally on
localhostor127.0.0.1.
Service worker
- A service worker can add offline support. It isn't required for installation. A manifest alone doesn't make your pages work offline.
Output
How to use your manifest
A web app manifest tells browsers how your installed app should look and open. Start with your app's full name and a short name for places with less room, such as the Home Screen.
- Set
start_urlto the page that should open when someone launches the app. Keep it insidescope. For an app under/notes/, use/notes/for both. Usestandaloneto open it without the usual browser toolbar. Keep theidstable when you update the app. - Replace the sample icon paths with files you've created. Upload them at those paths, with dimensions that match the
sizesvalues. Adding a row here doesn't create or resize an image. - Download
manifest.jsonand publish it at your site root. In Astro, put it inpublic/manifest.json. Copy the HTML snippets into the<head>of every app page, usually through a shared layout.
You can call the file manifest.webmanifest instead. Update the link's href to match, and serve it with theapplication/manifest+json content type.
Test the published manifest
Open your app in Chrome, then open DevTools → Application → Manifest. Check that the name, start URL and icons load. The panel reports problems such as missing icon files. Use its maskable icon preview to check that the logo survives cropping. See the Chrome DevTools guide.
If the manifest doesn't appear, check the link tag and open its URL directly. It should return JSON, rather than a 404 page or your site's HTML fallback. Check each icon URL too. Then try installing the app on the browsers and devices you support.
Chromium's installation checks include a name, 192×192 and 512×512 icons, a start URL and an app display mode. Requirements vary across browsers; generating this file doesn't guarantee an install prompt. MDN explains the current PWA installation requirements.
Download the JSON to keep your complete configuration, including your icon rows.
Read more
Free books, courses, and software
Get my programming books, course editions, and complete software.
Get the download library →