JMAP webmail

This is a webmail client for JMAP protocol.

Every section is capability-gated: the left tool rail only shows what the signed-in server actually advertises.

• Mail — read/compose/reply, mark read, bulk actions, attachments (upload + download), a contact picker in the composer, live push updates.
• Contacts — full CRUD, plus .vcf import (ContactCard/parse).
• Calendar — day / week / month / year views, a mini-month navigator, a per-calendar show/hide list, event CRUD, .ics import, and free/busy hints from Principal/getAvailability.
• Files — browse/upload/download/delete file storage (FileNode).
• Filters — manage server-side Sieve scripts (edit, validate, activate).
• Settings — vacation responder, storage quota, and browser push notifications (Web Push via a service worker).
• Switching — a header account switcher (shared mailboxes) and a send-from identity switcher (used by compose and quick reply).

Run it locally

npm install
npm run dev

And open your web browser at: http://localhost:3000/

Try it locally against a real JMAP server

A local Stalwart server can be spun up with Docker Compose so you can use the webmail (and run the integration tests) against a real backend:

docker compose up -d           # boot Stalwart
node dev/stalwart-setup.mjs    # complete setup + create test@example.org + seed mail
npm run dev                    # webmail at http://localhost:3000

Then sign in:

1. Enter the identifier test@example.org and tick More options.
2. Set the Endpoint to http://localhost:3000/.well-known/jmap.
3. Password: jmap-webmail-test-passphrase-2026, then Sign In.

The Vite dev server proxies the JMAP endpoints to Stalwart (same-origin, so no CORS issues) and the setup script also enables permissive CORS on the server.

Run the tests against the same server with:

npm run test:integration   # JMAP client (vitest, Node)
npm run test:e2e           # end-to-end in a real browser (Playwright)

See dev/stalwart/README.md for details. The integration tests also run in CI via .github/workflows/integration.yaml.

Known issues

Endpoint discovery from an email address only works if the target server serves /.well-known/jmap over HTTPS with the correct CORS headers. For servers without CORS (including the local Stalwart above), sign in via More options and set the endpoint manually.