e.V.
Packages · Backbone · Klasse B · v0.1.1
A

@mana/shared-app-tpl

Hono-Helpers für föderierte Vereins-Apps — Manifest-Serving, Share-Receive-Router, Tools-Router, DSGVO-Export.

Ersetzt
App-spezifische Foederations-Boilerplate
Was es tut

@mana/shared-app-tpl ist das Template, das jede föderierte Vereins- App von Anfang an föderations-tauglich macht. Mit pnpm add @mana/shared-app-tpl und drei Zeilen Konfiguration bekommt eine neue App:

  • Manifest-Serving unter /.well-known/mana-manifest.json — andere Apps erkennen, was sie senden und empfangen kann
  • Share-Receive-Router — eingehende Cross-App-Transfers von mana-share annehmen und zur App-Logik durchreichen
  • Tools-Router — AI-Tools für mana-mcp aus dem App-Manifest aus- liefern
  • DSGVO-Export-Endpunkt — auf Anfrage des Vereins-Backoffice (mana-admin) alle Daten des Users als JSON ausliefern

Klasse-B-Vertrag: Apps können das Paket benutzen, aber müssen nicht. Wer manuell föderieren will, kann das. Wer schnell starten will, nimmt das Template.

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-app-tpl

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.1
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

  • Datensouveränität
    Verwahrer statt Eigentümer.
  • Offenheit
    Code und Mittelverwendung öffentlich.
  • Eigenbetrieb
    Eigene Infrastruktur, quelloffener Stack.
Stand

Was läuft, was nicht

Version: v0.1.1.

Offene Punkte
  • Health-Routes-Standardisierung mit shared-hono noch zu vereinheitlichen.

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