All portfolio

App Password Mail Dashboard

A Gmail-styled webmail dashboard powered entirely by a Google App Password over IMAP, SMTP, and CardDAV. Zero OAuth setup required.

Web Development & Tools2026Open Source
App Password Mail Dashboard Inbox View
1 / 7

A lightweight, Gmail-styled open-source webmail dashboard featuring an Inbox, Sent folder, Compose functionality, and Contacts integration. It bypasses complex API setups by authenticating entirely through a standard 16-character Google App Password.

Challenge

Google requires complex OAuth 2.0 setups, consent screens, and Cloud Console projects for basic API access, making simple, self-hosted webmail integrations overly complicated for individual developers and small deployments.

Solution

Developed a Node.js and Express backend that communicates directly with standard mail protocols (IMAP for reading/searching, SMTP for sending, and CardDAV for contacts) using just an App Password, completely removing the need for refresh tokens or OAuth workflows.

Result

Successfully delivered a functional, easy-to-deploy webmail client that supports 50-per-page pagination, real Gmail-style search (via X-GM-RAW), and safe HTML email rendering within a sandboxed iframe.