Free Tool

PWA Manifest Generator

Build a web app manifest that follows the W3C spec and meets Chrome's install criteria, with every icon size you need listed. Copy the manifest and the head tags, and your site can be installed like an app.

App

Shown under the home screen icon.

URLs

The page the app opens on.
URLs that stay inside the app.
A stable identity. Never change it once installed.
BCP 47 tag, such as en or en-CA.

Display

Browser toolbar and title bar.
Splash screen while the app loads.

Icons And Categories

Where the icon files will live. Every icon path builds from this.
Optional. A hint for app stores and catalogues.
Enter the app name. The manifest builds as you type.

Free, no signup. Runs in your browser, nothing you type leaves this page.

Every result has a shareable link.

What A Web App Manifest Is

A web app manifest is a small JSON file that tells the browser how your site should behave when someone installs it: its name, its icon, the page it opens on, the colours of its splash screen and toolbar, and whether it runs in its own window. It is defined by the W3C Web App Manifest specification and linked from every page with <link rel="manifest">.

The manifest is one of the two pieces that make a site a Progressive Web App, along with HTTPS. A service worker adds offline support and caching on top. Without a valid manifest, a browser has nothing to install.

What This Generator Builds

Three outputs, all from the fields on the left:

  1. manifest.json with id, name, short_name, description, lang, start_url, scope, display, orientation, theme_color, background_color, categories and icons.
  2. The icon list: every file to create, its size, its purpose and where it is used, including the files that sit outside the manifest such as the Apple touch icon and favicons.
  3. The HTML head tags that link the manifest, set the theme colour and point to the icons.

How The Checks Work

Scope And Start URL

The spec says the start URL must be within scope. The tool resolves both against a test origin and checks that the start URL path begins with the scope path. If it does not, browsers ignore your scope and fall back to the folder of the start URL, which usually means links you expected to stay in the app open in a browser tab. The tool also warns when scope does not end with a slash, because /app matches /apple too.

Identity

The id member gives the app a stable identity, resolved against the start URL's origin. Without it, the start URL is the identity, so changing the start URL later makes browsers treat the app as a new one. Set id once and never change it.

Install Criteria

Chrome offers install when the manifest has a name or short name, 192px and 512px icons, a start URL, and a display mode of standalone, fullscreen or minimal-ui, served over HTTPS. The generator always includes both icon sizes and flags the browser display mode.

Labels And Formats

Home screens truncate long labels, so the tool warns when the short name passes about 12 characters. That is common guidance, not a spec limit. Colours must be valid hex values and lang should be a BCP 47 tag such as en-CA.

The Icons, Explained

  • 192 and 512, purpose any: the standard icons for the home screen, install dialogs and splash screen.
  • 512 maskable: Android crops icons into circles, squircles and other shapes. A maskable icon fills the whole square with background, and keeps the logo inside the safe zone, a central circle 80 percent of the icon's width. Give it its own file rather than marking one image as both any and maskable, because a maskable design looks too small when shown uncropped.
  • Apple touch icon, 180px: iOS and iPadOS use this link tag for the home screen icon. Use an opaque background, because transparent areas render black.
  • Favicons: 16 and 32 pixel PNGs for tabs, a 48 pixel PNG because Google Search asks for a favicon that is a multiple of 48px, and a favicon.ico at the root for older browsers and tools that request it by default.

What To Do Next

  1. Export the icons at the listed sizes from one square source, at least 512px.
  2. Upload manifest.json to the site root and the icons to your icon folder.
  3. Paste the head tags into the template every page uses.
  4. Open Chrome DevTools, Application panel, Manifest. Fix any errors it lists.
  5. Run Lighthouse, then test install on a real Android phone and an iPhone.

Mistakes To Avoid

  • Changing the id or start URL after launch. Installed copies can stop updating or appear twice.
  • Start URL outside scope, often after adding a tracking parameter path like /pwa/start under a scope of /app/.
  • One logo file for everything. A logo with no padding gets cropped by maskable shapes.
  • Theme colour that clashes with the site header, which makes the toolbar look broken.
  • Forgetting the head tags on some templates, so the manifest only loads on half the site.

The Agency Angle

A PWA is often the fastest way to give a client an installable app without app store review. Wise Media uses this logic on client app builds: a fixed id from day one, a complete icon set, and an install test on real devices before handover.

Fix What This Measured

App Development Agency Course

The App Development Agency Course takes a PWA from manifest to launch: the service worker and caching strategy, offline behaviour, install prompts, push notifications, and how to price and scope an app build for clients.

Rather Not DIY It?
Let Wise Media Build It.

The tool shows the gap. The studio closes it: brand, site, app and AI, then the ads, email, content and search that turn them into revenue.

Website Development

Custom sites with one job per page, built fast for phones, search and AI answers.

From $3,000CAD one timeSee Website Development

App Development

Web apps, portals and dashboards on Next.js, Supabase and Stripe, installable on any phone.

From $5,000CAD one timeSee App Development

Paid Advertising

Meta, Google and TikTok campaigns built on the offer and page first, reported as one number.

From $750CAD per monthSee Paid Advertising
wisemedia.io#1wisemedia.io

SEO & AI Search

Rank in Google, get named by ChatGPT and Claude, and convert the visit after the click.

From $350CAD per monthSee SEO & AI Search
AiPsAaSF ProDisplayCOLOR PALETTEHEADINGSSF Pro Display BoldBODYSF Pro Text, set for legibility

Brand Identity

Positioning, logo suite, colour, type and the guide that keeps it consistent.

From $750CAD one timeSee Brand Identity

AI Agents & Automation

Custom AI agents, LLM features and n8n automation connected to the tools you already use.

From $1,000CAD one timeSee AI Agents & Automation

Content Production

Short form video, carousels and AI clone content produced on a weekly calendar.

From $750CAD per monthSee Content Production
3

Email Marketing

Campaigns written and sent, lifecycle flows and SMS, every send tied to revenue.

From $350CAD per monthSee Email Marketing

Website Care

Updates, daily backups, monitoring, edits and search maintenance handled every month after launch.

From $100CAD per monthSee Website Care
MFADMARCBackupsTraining

Cyber Security

Email, accounts, staff devices and company data protected, with the documents your insurer asks for.

From $250CAD per monthSee Cyber Security
AnsweredCRMDRDana R.403 555 0148PipelineNewQuotedBookedPaidLEAD SAVEDKitchen flood

Business Software

Website analytics and a CRM, then an AI receptionist, then full operations software, on one system.

From $149CAD per monthSee Business Software
CLICKLEADBOOKED

Conversion Systems

Landing pages, funnels, tracking and follow up, so paid traffic turns into booked work.

From $1,500CAD one timeSee Conversion Systems

PWA Manifest Generator Questions

Straight answers on using it and acting on the result.

Quick Answer

What Does A PWA Manifest Need?

A valid manifest.json needs a name or short_name, a start_url, a display mode such as standalone, and icons at 192px and 512px, served over HTTPS and linked with link rel manifest. Add an id, a scope that contains the start_url, theme and background colours, and a separate 512px maskable icon.

  • Spec. W3C Web App Manifest
  • Required icons. 192x192 and 512x512, plus 512 maskable
  • Apple icon. apple-touch-icon at 180x180

FAQ

Frequently Asked Questions

It is the web app manifest: a JSON file that tells browsers how to install and display your site as an app, including its name, icons, start page, colours and display mode. It is defined by the W3C Web App Manifest spec and linked with a link rel manifest tag.

In the manifest: 192x192 and 512x512 with purpose any, plus a 512x512 maskable icon. Outside it: a 180x180 apple-touch-icon for iOS, and favicons at 16, 32 and 48 pixels with a favicon.ico at the root.

An icon designed to be cropped into different shapes by Android. The background fills the full square and the logo stays inside a central circle 80 percent of the width, so nothing important is cut off whatever shape the device uses.

Either works in all major browsers. The spec registers the .webmanifest extension and the application/manifest+json media type. If you use manifest.json, make sure the link tag points at the same file name.

A stable identity for the installed app, resolved against the start URL origin. Browsers use it to recognise updates. Without it, the start URL is the identity, so changing that later can make browsers treat it as a different app.

Common causes: no 192px or 512px icon, display set to browser, the manifest not linked or failing to load, or the site not served over HTTPS. Open Chrome DevTools, Application, Manifest to see the exact error.

Chrome no longer requires one just to offer install, but a service worker is what gives the app offline support, fast repeat loads and push notifications. Most real PWAs need one. The manifest and the worker solve different problems.

Usually the colour of your site header, so the browser toolbar or app title bar blends into it. The background colour should match the page background, because it fills the splash screen while the app loads.

Rather Have It
Done For You?

Wise Media builds and runs this for clients. Thirty minutes with Cody: the bottleneck named, the fix scoped, the price on the table.