module-mail

FuzzyPeanut Mail module — Svelte webmail client backed by Stalwart, a modern Rust mail server (SMTP/IMAP/JMAP).

What it does

• Full mailbox view with thread grouping (JMAP Thread/get)
• Read emails: HTML body with DOMPurify sanitization, plain text fallback
• Compose and send with draft autosave every 30s
• Cross-module integration: attach files from module-files, pick contacts from module-contacts, accept calendar invites into module-calendar
• Auto-provisioned mailboxes via the auth provisioning service

Services

Quick start

# Required environment variables (see docker-compose.yml)
REGISTRY_URL=http://shell-registry:3100
MODULE_UI_URL=http://localhost:3001
MAIL_DOMAIN=mail.fuzzypeanut.local
AUTHENTIK_JWKS_URL=https://auth.fuzzypeanut.local/application/o/fuzzypeanut/.well-known/jwks.json

docker compose up

Stalwart OIDC configuration

Stalwart validates JMAP Bearer tokens using Authentik's JWKS endpoint. The starter config at config/stalwart/config.toml includes the OIDC section as a template — verify the config key names against your Stalwart version's docs before deploying:

• https://stalw.art/docs/auth/oauth

Set AUTHENTIK_JWKS_URL in your environment to the Authentik JWKS URL for your FuzzyPeanut application:

https://<authentik-host>/application/o/fuzzypeanut/.well-known/jwks.json

Development

npm install
npm run build        # produces dist/remoteEntry.js
npm run dev          # watch mode

The module is a Vite library build (not a SvelteKit app). src/index.ts exports the FPModule default.

Module events