Quick Mail
A fast, clean Gmail client that lives in your Chrome popup.

v1.0.0 — Released April 7, 2026

---

About

Quick Mail is a lightweight Chrome extension that gives you full email power without ever opening Gmail. Compose, search, read, and reply to messages directly from the browser toolbar — all in one clean popup.

Built for speed and simplicity, it connects securely to your Gmail account and keeps everything organized with proper threading.

---

Features

• Compose Emails
  Rich text editor with bold, italic, underline, and highlight. Attach files up to 10 MB (images, PDFs, docs, etc.). Smart autocomplete for recipients from your contacts and sent mail.

• Inbox
  Instantly loads your 20 most recent emails. Powerful search across subjects, senders, and content. Clean list view with sender avatars, dates, and attachment indicators.

• Full Email View
  Click any email to read the complete message. Safe HTML rendering with automatic sanitization — no iframes or risky code.

• Reply with Threading
  One-click reply that keeps proper Gmail threading using threadId and messageId.

• AI Triage
  Built-in AI assistant that analyzes every opened email. It detects the category (spam, marketing, support, billing, legal, finance, HR, sales, personal), sets priority level, suggests the best action, and generates a ready-to-send reply draft with one click.

• Enjoy Tab
  Quick random jokes to brighten your day (powered by the Official Joke API).

• Help & Contact
  Full user guide and direct support links inside the extension.

• Smart Extras
  Real-time online/offline detection with toast notifications. Message badge with animation. Works smoothly even when you’re offline.

---

Installation

1. Download or clone this repository.
2. Open Chrome and go to chrome://extensions/
3. Turn on Developer mode (top right).
4. Click Load unpacked and select the folder containing manifest.json, popup.html, popup.js, and popup.css.
5. Pin the Quick Mail icon to your toolbar for quick access.

(Chrome Web Store version coming soon.)

---

How to Use

1. Click the Quick Mail icon in your toolbar.
2. Sign in with your Google account (one-time OAuth — only Gmail read/send permissions are used).
3. Start composing, browsing your inbox, or replying on the fly.

That’s it. No extra setup required.

---

Privacy & Security

• All communication happens directly with Google’s Gmail API.
• No data is stored or sent to any third-party servers except Google.
• Email body rendering is fully sanitized using DOMParser.
• 100% CSP compliant with zero inline scripts.
• You can revoke access anytime from your Google Account settings.

---

Technical Details

• Built with vanilla JavaScript, HTML, and CSS.
• Uses Chrome Extension Manifest V3.
• Communicates with a background service worker for Gmail API calls.
• AI triage powered by a lightweight backend (FastAPI — included in the repo).
• Fully responsive popup sized at 360×680 px.

---

Changelog

v1.0.0. (April 7, 2026)

• Full public release
• Added AI Triage with category detection, priority, action suggestions, and reply drafts
• Fixed Enjoy tab joke loader
• Cleaner title bar
• Improved overall stability and error handling

---

Made with ❤️ by Porocox, India

If you have any questions, feature requests, or find a bug, feel free to reach out:

• Email: incbluedragon@gmail.com --support
• Email: porocoxindia@gmail.com --quick support
• Or use the Contact tab inside the extension

---

Star this repo if you like it!
Quick Mail — email, made simple again.