Das @docmd/plugin-pwa-Plugin verwandelt Ihre Dokumentationsseite in eine installierbare Progressive Web Application (PWA). Es generiert ein W3C Web Application Manifest (manifest.webmanifest) und registriert einen Service Worker für Offline-Caching und die Installation auf mobilen Plattformen.

Konfigurationsoptionen

Konfigurieren Sie PWA-Eigenschaften in docmd.config.json:

Globales Konfigurationsbeispiel

{
  "plugins": {
    "pwa": {
      "themeColor": "#1e293b",
      "bgColor": "#ffffff",
      "logo": "assets/app-icon.png"
    }
  }
}

Hauptfunktionen

• Offline Service Worker: Implementiert eine Stale-While-Revalidate-Caching-Strategie. Seiten werden sofort aus dem lokalen Cache geladen, während der Netzwerkstatus im Hintergrund überprüft wird.
• Home-Screen-Installation: Gibt gültige Manifest-Metadaten aus, mit denen Benutzer die Dokumentationsseite auf iOS, Android, macOS und Windows anheften können.
• Asset-Skalierung: Generiert automatisch die erforderlichen PWA-Icon-Größen (192x192, 512x512) aus dem primären Site-Branding.

Priorität der Icon-Auflösung

Das PWA-Plugin wertet Icon-Pfade in folgender Reihenfolge von oben nach unten aus:

1. plugins.pwa.icons — Explizites Icon-Array, das in der Konfiguration definiert ist.
2. plugins.pwa.logo — Plugin-spezifischer Icon-Pfad.
3. config.logo — Globaler Site-Logo-Pfad.
4. config.favicon — Globaler Site-Favicon-Pfad.