Repository navigation
Releases
v0.10.1: preload fonts
First-screen fonts are preloaded (mobile layout shift 0.19 → 0.015). Lighthouse on production: desktop 100/100/100/100, mobile 95/100/100/100.
v0.10.0: installable app and listen to an email
Inbox Bubble Map v0.10
- Install it like an app (#31): add it to your phone home screen or desktop. Works offline for the app shell; mail and sign-in always go live.
- Listen to an email: the reader reads aloud with a voice matched to the email's language (Arabic, French or English).
v0.9.0: whole mailbox, Outlook stays signed in
Inbox Bubble Map v0.9
- All your mail (#29): the newest messages appear in seconds, then the rest of your mailbox keeps loading in the background with a live counter and time estimate. Progress is saved as it goes, so if you close the tab it carries on next time.
- Outlook / Hotmail sign-in is on (#22) and stays signed in, with the same instant cached map, background refresh, account menu and log out as Gmail.
v0.8.0: stay signed in, instant map, incremental sync
Inbox Bubble Map v0.8 works like a real mail client.
- Stay signed in (#27): sign in with Google once. Your session is sealed in an encrypted, httpOnly cookie in your own browser, and our servers store nothing. Log out any time from the account menu; that revokes access.
- Instant map: your mailbox headers are cached on this device, so the map opens straight away.
- Only new mail syncs: the Gmail History API brings in new mail, read-state changes, trash and spam since your last visit. Load older mail reaches further back.
- Demo, files and app passwords are still there for visitors.
While the Google app is in Testing mode, Google ends test sessions after 7 days. Verification removes that limit.
v0.7.2: shared Gmail throttle
v0.7.2: opening a sender while a Gmail import is still streaming no longer runs into Gmail's rate limit. The import and the sender panel share one throttle; your clicks go first and the background import makes room. (#25)
v0.7.1: Gmail rate limits and streaming map
v0.7.1: Gmail import now works on big mailboxes.
- Gmail caps reads at about 50 messages per second and answers
403 rateLimitExceededabove that, which used to stop imports after about 100 messages. Reads are now paced, back off and continue, and skip any single message that fails. (#23) - The map opens after the first ~200 messages and keeps growing, with a live counter, so 2,000 to 5,000 messages no longer mean staring at a progress bar.
- Arabic font subsets load under the CSP.
v0.7.0: read and act on mail, one-click unsubscribe, Arabic and French
Inbox Bubble Map v0.7: read and clean your mail without leaving the map, in Arabic, French or English.
Live app: https://inbox-bubble-map.vercel.app
Highlights
- Read mail (#17): open any sender's newest messages. The reader blocks remote images and fonts, so tracking pixels never fire, runs no scripts, and opens links in a new tab.
- Clean up for real (#18): mark read, archive, move to trash or report spam, for one message, a whole sender, or every selected bubble. You confirm first, trash stays recoverable, and emptied senders pop off the map.
- One-click unsubscribe (#5): the standard RFC 8058 request goes through a hardened relay. Gmail can also send the unsubscribe email for you.
- العربية / Français / English (#19): a language switcher everywhere, a right-to-left Arabic layout, and local dates and numbers.
- Google sign-in is on (#20). While the Google app is in Testing mode, only listed test users can connect Gmail. Microsoft sign-in still needs its client ID.
Quality
63 tests pass, plus 4 end-to-end IMAP tests against a GreenMail server. Checked in headless Chromium under the production CSP in Arabic dark, French light and mobile. The live relays were probed on production.
Full list in CHANGELOG.md.
v0.6.1 — logo caching fix
Fix: the catch-all /api/(.*) no-store header (meant for the IMAP relay) overrode the logo proxy's cache headers. It is now scoped to /api/imap, so company logos are cached in the browser for 1 day and at the CDN for 30 days (verified: second request is a CDN HIT). (#16)
v0.6.0 — premium design with logos, colour classes, pin anywhere, groups
Inbox Bubble Map v0.6: a premium look with company logos, colour classes and filters, and a map you can arrange yourself.
Live app: https://inbox-bubble-map.vercel.app
Highlights
- Premium design (#12): Geist + Instrument Serif type, aurora background, glass panels, glossy 3D bubbles, and company logos on white plates (initials for people).
- Private logos: icons load through this site's
/api/logoproxy, so no icon service ever sees who emails you. - Colour classes and filters (#13)
- Colour by type, unread rate, last seen or "can unsubscribe", each with its own legend.
- Filter by unsubscribable, unread %, volume, recency and Gmail tab.
- Arrange it your way (#14)
- Drag bubbles anywhere and they stay (double-click to release).
- Orbit, Clusters or Free layouts.
- Shift-click, lasso or "select all newsletters", then move the whole group, add it to cleanup or pop them all.
Quality
43 tests. Logos, pins, group selection, filters and both themes were checked in a headless browser.
Next: #5 (one-click RFC 8058 unsubscribe and optional in-app bulk archive). Full list in CHANGELOG.md.
v0.4.0 — free-moving bubbles, any provider, insights
Inbox Bubble Map v0.4: the map comes alive, and any inbox can connect.
Live app: https://inbox-bubble-map.vercel.app
Highlights
- Free-moving bubbles (#7). Bubbles float, and you can drag and fling them while the others make room. They burst out of "You" on load, wobble on hover, and pop with particles when you clean a sender up (undo included).
- Connect any inbox (#4, #8):
- Gmail: Google sign-in or an app password.
- Outlook / Hotmail / Microsoft 365: Microsoft sign-in,
Mail.ReadBasic. - Yahoo, iCloud, AOL, GMX, Zoho, Fastmail or any IMAP server: app password, through a stateless relay that reads headers only and stores nothing.
- Insights (#9): time range chips, list share, list mail per week, senders you never open, and how many emails a year your cleanup list will save. Each sender also gets a 12-month activity chart.
- Exports (#10): CSV, Gmail filters, Sieve rules and the map as a PNG.
Security
The relay accepts TLS on port 993 only. A public-DNS SSRF guard pins the connection to the checked address. It also enforces a same-origin check, a body limit, a per-IP rate limit and a lockout after failed logins, and never logs credentials or mail.
Notes
Google and Microsoft sign-in need client IDs set on the deployment (VITE_GOOGLE_CLIENT_ID, VITE_MS_CLIENT_ID; see .env.example). Without them, Gmail works through an app password and Outlook users are guided to an .mbox export.
Next: #5 (one-click RFC 8058 unsubscribe and optional in-app bulk archive). Full list in CHANGELOG.md.