e.V.
Packages · UI & Branding · Klasse B · v0.1.0-alpha.5
P

@mana/shared-pwa

PWA-Boilerplate für Vereins-Apps — Vite-Plugin, Theme-Bridge, Install-Banner, Update- und Offline-Komponenten.

Ersetzt
App-spezifische PWA-Setups, Workbox-Konfigurationsdrift
Was es tut

@mana/shared-pwa ist die PWA-Foundation für 10 Vereins-Apps. Vite- Plugin-Konfiguration, Service-Worker-Setup, Theme-Bridge zu @mana/themes, Svelte-5-Komponenten für Install-Banner mit App-Icon, Update-Notification und Offline-Fallback.

Warum eigene PWA-Foundation? Weil Android-Erreichbarkeit ohne Native- App durch Web-App-Manifest geschieht — und das Manifest ist die Vereins-App, die auf dem Home-Screen landet. PWA-Setup falsch zu machen ist äquivalent zu „wir gibt’s auf Android halt nicht”.

Mit dem Paket adoptieren neue Apps die PWA-Disziplin in zwei Schritten: pnpm add @mana/shared-pwa, drei Zeilen in vite.config.ts. Fertig.

Installation

Mitnehmen

Vereins-Pakete liegen auf der Vereins-eigenen Verdaccio-Registry. Apps und Services-Repos haben dort ein .npmrc, das den @mana/-Scope auf npm.mana.how routet.

pnpm add @mana/shared-pwa

Auch nutzbar mit npm oder yarn — der Scope-Mechanismus ist Standard-npm-Verhalten. Wer den Verein nicht-mitgliedlich nutzen will, kann die Registry frei konfigurieren.

Klasse & Technik

Worauf es sich bindet

Klasse
Klasse B — Foundation — intern-versioniert, große Adoption erwartet.
Sprache
TypeScript
Version
v0.1.0-alpha.5
Registry
npm.mana.how — eigene Vereins-Registry, kein npmjs.com
Lizenz
Quelloffen — Details im Repo.
Grundsätze

Was es für den Verein verkörpert

  • Eigenbetrieb
    Eigene Infrastruktur, quelloffener Stack.
  • Langlebigkeit
    Bewährte Stacks, gute Doku.
  • Achtsamkeit
    Keine Engagement-Tricks.
Stand

Was läuft, was nicht

Version: v0.1.0-alpha.5.

Offene Punkte
  • Erweiterte Offline-Sync-Patterns für Apps ohne Event-Sourcing dokumentieren.

@mana/shared-pwa ist eines von vielen Paketen, die der Verein selbst pflegt — eigene Bauteile auf eigener Registry, frei nachnutzbar.