Convex · MIT-Lizenz

Convex Mail Bridge.

IMAP und SMTP für eine Convex-App, ohne eigenen Mailserver: Apple Mail, Thunderbird und Outlook lesen und senden die Nachrichten deiner App.

InstallierenGitHub

Version 0.1.0 vom 11.10.2026 · Convex · TypeScript · Go

Installation

Installiere das Paket über deinen Paketmanager:

npm install @nordwerk/convex-mail-bridge

Was es kann

Deine App bleibt der einzige Speicher. Die Weboberfläche und das Mailprogramm lesen dieselben Datensätze: Wer eine Nachricht in Apple Mail öffnet, markiert sie in derselben Transaktion auch in der App als gelesen.

Die Convex-Komponente gibt jeder Nachricht eine stabile IMAP-UID und verwaltet die Anmeldung der Mailprogramme: ein Passwort je Gerät, einzeln widerrufbar. Der Go-Dienst davor spricht IMAP und SMTP und hält selbst keinen Zustand. Ein Neustart verliert nichts.

Erste Schritte

Komponente installieren und in convex/convex.config.ts einhängen, dann die Fragen der Bridge beantworten: Welches Postfach gehört zu einer Adresse, wo liegen die Bytes einer Nachricht, und was passiert in deinen Daten, wenn ein Mailprogramm etwas als gelesen markiert. Den Go-Dienst stellst du davor und richtest das Mailprogramm darauf ein.

Die vollständige Anleitung, eine Beispiel-App und die bekannten Grenzen stehen im README auf GitHub.

Häufige Fragen

Wofür ist die Convex Mail Bridge gedacht?

Für Convex-Apps, die Nachrichten schon speichern, etwa Support-Verläufe oder ein gemeinsames Postfach. Die Bridge zeigt diese Nachrichten in gewöhnlichen Mailprogrammen, ohne dass du einen IMAP-Server daneben betreibst und zwei Speicher abgleichst.

Wie ist sie aufgebaut?

Aus zwei Teilen. Eine Convex-Komponente vergibt stabile IMAP-UIDs, führt Flags und Zähler je Ordner und verwaltet ein Passwort je Gerät. Ein kleiner Go-Dienst spricht IMAP und SMTP mit dem Mailprogramm und holt alles über HTTP-Routen aus deiner App. Er hat weder Festplatte noch Datenbank.

Was funktioniert heute?

Posteingang und Gesendet, Lesen, Flags in beide Richtungen, Löschen, IDLE für neue Post innerhalb von Sekunden, Senden über SMTP, geteilte Postfächer und Profildateien für Apple-Geräte. Weitere Ordner, Verschieben, Suche im Nachrichtentext und Entwürfe auf dem Server fehlen noch.

Ist das ein vollständiger Mailserver?

Nein. Die Bridge nimmt keine Post aus dem Internet an, sondern nur Nachrichten angemeldeter Geräte, und reicht sie an deine App weiter. Empfang und Versand nach außen bleiben bei den Diensten, die deine App dafür schon nutzt. Deine App muss die Nachrichten als RFC-822-Bytes vorhalten oder erzeugen können.

Wie weit ist das Projekt?

Früh. Komponente und Go-Dienst laufen bei uns im Einsatz. Die Schicht, die sie mit deinen eigenen Tabellen verbindet, ist durch Tests abgedeckt, hat in dieser Form aber noch keinen Produktionsverkehr getragen. Vor Version 1.0 kann sich die Schnittstelle ändern.

Welche Lizenz gilt?

Das Paket steht unter der MIT-Lizenz. Kommerzielle Nutzung und Anpassungen sind erlaubt; Lizenz- und Copyright-Hinweise müssen bei Weitergabe erhalten bleiben.