Dashboard und Administrationsoberfläche für MeshCore-Meshes.
MeshDash verbindet sich mit einem MeshCore-Companion-Node und macht daraus eine Web-App: Nodes und Nachbarn im Blick, Nachrichtenverlauf, Telemetrie über die Zeit, Karte, und perspektivisch Fernadministration von Repeatern und Room-Servern.
Status: MeshDash öffnet auf der Karte. Der Dienst spricht über Serial oder TCP mit einem Companion-Node, verbindet sich nach einem Abriss selbsttätig neu und speichert nach SQLite. Die Oberfläche liegt auf der Fläche mit den Knoten darauf; Verbindung, Knoten, Gespräche je Kontakt und Kanal sowie Telemetrie über die Zeit öffnen sich als Blende darüber. Nachrichten lassen sich senden, Wege messen, der eigene Node verorten und dem Mesh vorstellen; Listen lassen sich durchblättern, durchsuchen und auf einen Zeitraum eingrenzen. Live-Ereignisse laufen über WebSocket.
Wohin es geht: Kartenkacheln über den Dienst, dazu die Ebenen für Verbindungen und Verkehr (ADR-0011). Der Stand und der Weg dorthin:
docs/roadmap.md.
| Aspekt | Entscheidung |
|---|---|
| Backend | Rust — ADR-0001 |
| Frontend | React + Vite + TypeScript — ADR-0001 |
| Auslieferung | Ein einzelnes Binary mit eingebettetem Frontend |
| Architektur | Modularer Kern, Features als eigenständige Module — ADR-0002 |
| Anbindung | USB/Serial und TCP zuerst, BLE später — ADR-0003 |
| Zielhardware | Läuft auf einem Raspberry Pi, nicht nur auf einem Server |
Ausführlich: docs/architecture.md.
Ein MeshCore-Companion-Node spricht ein binäres Protokoll über Serial, TCP oder BLE. Die vorhandenen Clients sind auf Bedienung ausgelegt — ein Chat-Fenster, eine Kontaktliste. Was fehlt, ist die Betreiber-Sicht: Was macht mein Mesh über die Zeit? Welcher Repeater ist weggebrochen? Wie entwickelt sich die Batterie an Standort X? Welche Pfade nutzt das Netz gerade? Genau da setzt MeshDash an.
Der Einstieg ist docs/README.md — dort ist der gesamte
Dokumentationsbestand indiziert. Die wichtigsten Startpunkte:
docs/architecture.md— Zielarchitektur und Datenflussdocs/module-system.md— wie Module aufgebaut sinddocs/development.md— Arbeitsumgebung einrichtendocs/conventions.md— Code-, Commit- und Branch-Konventionendocs/decisions/— Architecture Decision Recordsdocs/lessons-learned.md— was uns schon auf die Füße gefallen istdocs/glossary.md— MeshCore-Begriffe
Für KI-Agenten: CLAUDE.md.
git clone https://github.com/Jarod1230/MeshDash.git
cd MeshDash
just setup # Frontend-Abhängigkeiten
just check # alles, was auch die CI prüftOhne just stehen dieselben Befehle im
justfile und in docs/development.md.
Siehe CONTRIBUTING.md. Sicherheitsrelevantes bitte nicht
über öffentliche Issues melden — SECURITY.md.
MeshDash ist ein unabhängiges Projekt und steht in keiner Verbindung zum MeshCore-Projekt oder dessen Entwicklern.