What is a Web App Manifest?
You'll learn: How a simple JSON file transforms your website into an installable, app-like experience.
The Core Idea
A Web App Manifest (manifest.json) is a JSON configuration file that tells browsers and operating systems how to treat your website like a native application. Think of it as an "identity card" for your web app—it declares the app's name, icons, colors, and display preferences so users can install it directly to their home screen or desktop.
Without this file, your site is just a website. With it, your site becomes a Progressive Web App (PWA) that can:
- Be installed from the browser
- Launch in a standalone window (no browser UI)
- Appear in app launchers and task switchers
- Display a splash screen during launch
What Goes Inside
The manifest declares metadata like:
{
"name": "My Awesome App",
"short_name": "AwesomeApp",
"start_url": "/",
"display": "standalone",
"background_color": "#ffffff",
"theme_color": "#3367D6",
"icons": [
{
"src": "/icon-192.png",
"sizes": "192x192",
"type": "image/png"
}
]
}
Link it in your HTML's <head>:
<link rel="manifest" href="/manifest.json">
Why It Matters
The manifest bridges the gap between web and native apps. Users get familiar app-like behavior—persistent home screen access, immersive full-screen mode—while you maintain the reach and updatability of the web. Browsers use this file to render install prompts and configure how your PWA launches.
Key Takeaway: The Web App Manifest is a JSON file that provides installation and display instructions, transforming your website into an installable progressive web application with app-like behavior.