Modern lightweight webmail for Mox + Moggie — HTMX + Alpine.js
- Python 49.3%
- HTML 28.3%
- CSS 21.8%
- Shell 0.6%
| .forgejo/workflows | ||
| bridge | ||
| data | ||
| demo | ||
| static | ||
| templates | ||
| tests | ||
| .gitignore | ||
| 5 | ||
| chaski-mail.service | ||
| deploy.sh | ||
| error: | ||
| install_deps.sh | ||
| pyproject.toml | ||
| README.md | ||
| requirements.txt | ||
ChaskiMail
Modern lightweight webmail for Mox + Moggie — named after the Chaski, the Inca messenger runners.
Architecture
- Frontend: HTMX + Alpine.js (zero build step)
- Bridge: Python 3 + FastAPI (WebSocket to Moggie, IMAP to Mox)
- Mail server: Mox (SMTP/IMAP/DKIM/DMARC/ACME)
- Mail index: Moggie (search, PGP, tags)
Features
- Gmail-style compose window with Quill WYSIWYG editor
- Reply / Forward with quoted message body
- Labels with colored dots and bulk actions
- Keyboard shortcuts (j/k navigation, r reply, f forward, c compose, ? help)
- Dark theme (Catppuccin Mocha) + light theme toggle
- Mobile responsive layout with swipe navigation
- Multi-select with bulk archive/delete/spam/label
- Tag management with predefined and custom labels
- Settings page for display name, signature, and theme
Quick Start
pip install -r requirements.txt
python -m bridge.main
Stack
| Layer | Technology |
|---|---|
| Frontend | HTMX 1.9 + Alpine.js 3.x |
| Editor | Quill 1.3 (Snow theme) |
| Bridge | FastAPI + Jinja2 |
| Mail Server | Mox |
| Search/Index | Moggie (Mailpile v2) |
| Theme | Catppuccin Mocha |
License
AGPL-3.0