e.V.
Packages · Plattform-Klienten · Klasse B · v0.1.0-alpha.2
M

@mana/shared-map

Cross-App-Karten-Komponente — MapLibre GL JS, PMTiles-ready, OpenStreetMap-Kacheln. Eine Karte für alle Vereins-Apps.

Ersetzt
Google Maps SDK, Mapbox GL JS mit Mapbox-Tiles, Apple MapKit JS
Was es tut

@mana/shared-map ist die Karten-Komponente, die in allen Vereins-Apps eingesetzt wird, in denen Karten Sinn machen — Herbatrium für Pflanzen- Funde, Viadocu für GPS-Spuren, Seepuls für Veranstaltungs-Orte, Nutriphi für Restaurant-Standorte.

Stack-Wahl: MapLibre GL JS (Open-Source-Fork von Mapbox GL), PMTiles für eigene Tile-Hosting, OpenStreetMap-Kacheln als Standard-Basis. Astro und Svelte 5 als Konsumenten-Frameworks unterstützt.

Souveränitäts-Hook ist hier besonders klar: Google Maps kostet pro API-Call, Mapbox kostet pro Map-Load, Apple MapKit-JS hat Pflicht-Branding. Mit MapLibre + PMTiles fließt kein einziger Cent pro Karten-Anzeige nach außen. Eine Plattform-Investition, die sich pro Anwender-Anzeige rechnet, statt pro Nutzungs-Tag teurer zu werden.

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-map

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.

Konsumenten

Wer es benutzt

Klasse & Technik

Worauf es sich bindet

Klasse
Klasse B — Foundation — intern-versioniert, große Adoption erwartet.
Sprache
TypeScript
Version
v0.1.0-alpha.2
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.
  • Eigenbetrieb
    Eigene Infrastruktur, quelloffener Stack.
  • Offenheit
    Code und Mittelverwendung öffentlich.
Stand

Was läuft, was nicht

Version: v0.1.0-alpha.2.

Offene Punkte
  • Eigene Vereins-Tile-Pipeline auf PMTiles-Basis ist Roadmap.
  • Hover-Popup-Polish, Marker-Cluster für hohe Dichte.

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