Web-App-Manifest

Das Web-App-Manifest ist eine JSON-Datei, die einer Website die Angaben mitgibt, mit denen ein Betriebssystem sie wie eine App behandeln kann: Name, Symbole, Startadresse, Farben und die Art der Darstellung. Es ist die Voraussetzung dafür, dass sich eine Website auf dem Startbildschirm ablegen lässt.

Web-App-Manifest

Eine JSON-Datei, die einer Website die Angaben für ihre Installation als App mitgibt: Name, Symbole, Startadresse, Anzeigemodus und Farben.
Beispiel: „Ohne Web-App-Manifest bietet der Browser das Hinzufügen zum Startbildschirm gar nicht erst an.“

Auch: Webmanifest. Die Datei heißt üblicherweise site.webmanifest oder manifest.json und wird im Kopfbereich der Seite verlinkt.

Standard: beschrieben in der W3C-Spezifikation Web Application Manifest.

Was darin steht

{
  "name": "Homepage Helden Glossar",
  "short_name": "Glossar",
  "start_url": "/glossar/",
  "display": "standalone",
  "background_color": "#ffffff",
  "theme_color": "#0016fb",
  "icons": [
    { "src": "/icon-192.png", "sizes": "192x192", "type": "image/png" },
    { "src": "/icon-512.png", "sizes": "512x512", "type": "image/png" }
  ]
}

Der Kurzname erscheint unter dem Symbol auf dem Startbildschirm und sollte deshalb wenige Zeichen haben. Die Startadresse legt fest, wo die Anwendung beim Öffnen beginnt, und muss nicht die Startseite sein. Hintergrund- und Themenfarbe bestimmen den Startbildschirm und die Systemleiste.

Der Anzeigemodus

Die Angabe display entscheidet, wie viel Browser sichtbar bleibt. Mit browser öffnet sich ein gewöhnlicher Tab, mit minimal-ui ein Fenster mit reduzierten Bedienelementen, mit standalone ein eigenes Fenster ohne Adresszeile, und fullscreen nutzt den ganzen Bildschirm.

Bei standalone ist zu bedenken, dass die Adresszeile entfällt und damit auch der Zurück-Knopf des Browsers. Die Anwendung muss dann selbst einen Weg zurück anbieten, sonst sitzt der Nutzer fest.

Was das Manifest nicht leistet

Es beschreibt nur, es bewirkt nichts. Damit eine Website offline funktioniert, braucht es zusätzlich einen Service Worker, der Dateien zwischenspeichert und Anfragen abfängt. Erst beide zusammen ergeben eine Progressive Web App im eigentlichen Sinn.

Auch die Installation lässt sich nicht erzwingen. Browser entscheiden selbst, wann sie einen Hinweis anbieten, und knüpfen das an eigene Bedingungen, darunter HTTPS und ein Mindestmaß an Angaben im Manifest. Für eine gewöhnliche Unternehmenswebsite reicht deshalb meist ein knappes Manifest mit Name, Symbolen und Farben, das die Ablage auf dem Startbildschirm ordentlich aussehen lässt.