Kmail
Kmail — Koder Webmail
- *rea:*Workspace
- *ath:*
products/horizontal/kmail/engine - *ind:*Consumer webmail product (B2C flagship for Raven engine)
Role in the stack
Kmail is the consumerfacing webmail client that runs on top of the Raven email platform engine. It provides a fullfeatured web inbox: JMAP-backed mailboxes, composing, search, contacts, identities, Sieve filters, CalDAV event integration, and file attachment via Koder Drive.
Kmail (product) → Raven engine → Stalwart MTAPrimary couplings
| Consumer | Relationship |
|---|---|
products/horizontal/kmail/raven |
Email engine — domain provisioning, JMAP proxy |
| Stalwart MTA | JMAP source; blob upload for attachments and migration |
services/foundation/id/platform |
OIDC login and session JWT |
products/horizontal/drive/engine |
File attachment storage (ticket KMAIL-042) |
| Gmail API | Personal Gmail connector via OAuth 2.0 PKCE |
Gmail Connector
Kmail ships a personal Gmail connector (internal/gmail) allowing users to:
- *Auth connect*— PKCE Authorization Code Flow, stores token in
TokenStore - *rowse Gmail*— list labels, list/get messages
- *end via Gmail*— proxy raw MIME through Gmail API
- *igrate to Kmail*— bulk import: phase 1 inventories all message IDs, phase 2 downloads raw RFC 5322 bytes, uploads blob to Stalwart, calls
Email/importJMAP method; cancellable at any time - *abel mapping*—
SystemLabelMapconverts Gmail labels (INBOX, SENT, DRAFT, TRASH, SPAM, STARRED, IMPORTANT, CATEGORY_*) to JMAP mailbox names and keywords
Enabled conditionally when cfg.Gmail.ClientID is set. OAuth endpoints at /auth/gmail and /auth/gmail/callback are outside the auth group; API routes at `apigmail