How to meet the minimum PWA requirements
Checklist
| Requirement | Why it matters |
|---|---|
| Serve the Web App over HTTPS. | Installable PWAs require a secure origin. |
| Expose a Web App Manifest from every page in the app. | The manifest defines app-level identity and startup behavior. |
| Provide the minimum manifest fields required by WebSpatial Runtime. | The runtime needs app identity, icon assets, and start-scene settings. |
Add the manifest link
Add the manifest link to every HTML document
<link rel="manifest" href="/app.webmanifest" />
The manifest URL should return a JSON MIME type response, such as application/manifest+json.
Provide the minimum manifest fields
| Field | What it does | Notes |
|---|---|---|
name or short_name | Provides the app name. | At least one of these fields must be present. |
icons | Provides app icons. | Include at least one "purpose": "any" icon and one "purpose": "maskable" icon that is at least 1024×1024, has no transparent background, and has no rounded corners. |
start_url | Configures the URL for the start scene. | This determines which page loads first when the app starts. |
display | Configures the display mode of the webpage window. | WebSpatial Runtime currently supports only "standalone" and "minimal-ui". |
Minimum manifest for a WebSpatial-ready PWA
{
"name": "My Awesome App",
"start_url": "/",
"display": "minimal-ui",
"icons": [
{
"src": "/pwa-512x512.png",
"sizes": "512x512",
"type": "image/png",
"purpose": "any"
},
{
"src": "/pwa-1024x1024.png",
"sizes": "1024x1024",
"type": "image/png",
"purpose": "maskable"
}
]
}
Recommended Icons for Web Apps
Sample files
webspatial-icon-examples.zip contains icon files that already satisfy the requirements below.
| Size | Purpose | Where It Appears | Transparent Background Allowed | Rounded Corners Allowed | How to Provide It |
|---|---|---|---|---|---|
| 48 × 48 | favicon.ico | Browser tab | Required | Allowed | HTML <link> |
| 180 × 180 | iOS app icon | iOS "Add to Home Screen" | Not allowed | Not allowed | HTML <link> |
| 192 × 192 | Standard PWA icon | Small icon on the home screen | Required | Required | Web App Manifest |
| 512 × 512 | Standard PWA icon | Various launch surfaces, app markets, and similar places | Required | Required | Web App Manifest |
| 1024 × 1024 | Spatial app icon | visionOS, PICO OS 6 | Not allowed | Not allowed | Web App Manifest |