MailClearNow

Type
Product
Built with
TypeScript
Source
Private repository
Live at
www.mailclearnow.com
www.mailclearnow.com
MailClearNow screenshot

Overview

A Google-approved, CASA-compliant inbox cleaning service that scans a mailbox, identifies newsletter and mailing-list subscriptions, and unsubscribes from many senders in bulk.

Core features

OAuth connection to Gmail (Outlook in progress) with read-only scopes; inbox scanning that parses List-Unsubscribe headers and classifies sending domains to build a subscription inventory; one-click bulk unsubscribe with single, retry and retry-all paths for senders that fail; unsubscription history and success-rate tracking; an overview dashboard summarising subscription volume by sender; account management including full data deletion; three commercial tiers — a one-time clean, a monthly subscription and a lifetime plan — sold through PayPal.

Architecture

A single Next.js App Router application with route-handler API endpoints grouped by concern (gmail, outlook, scan, unsubscribe, subscriptions, paypal, account), NextAuth for session handling, and Prisma over a relational schema of users, email subscriptions, unsubscription history, user subscriptions and payments. Bulk unsubscribes run through a queue rather than inline request handling, so scanning thousands of messages and dispatching unsubscribe requests survives request timeouts.

Unsubscribe handling accounts for the fact that senders implement the standard inconsistently — RFC 8058 one-click POST, mailto: and HTTP-link variants are handled separately, with per-attempt outcomes recorded so users see what genuinely succeeded.

Frameworks, tools & libraries

The stack behind it

Frameworks

  • Next.js
  • React
  • Tailwind CSS

Tools & infrastructure

  • PostgreSQL
  • Gmail API (OAuth)
  • PayPal
  • Vercel Queues

Libraries

  • Prisma
  • NextAuth
  • TanStack Query
  • TanStack Table
  • Zod
  • Zustand
  • Framer Motion
  • Cheerio

Skills applied

What I brought to it

  1. 01

    Gmail / Microsoft OAuth integration with least-privilege read-only scopes

  2. 02

    Google CASA security assessment

    passing the compliance review required for restricted Gmail API scopes

  3. 03

    Email protocol work: List-Unsubscribe header parsing, RFC 8058 one-click unsubscribe, heterogeneous unsubscribe flows (HTTP and mailto)

  4. 04

    Bulk asynchronous job processing over large mailboxes

  5. 05

    Subscription billing and multi-tier pricing (one-time, recurring, lifetime)

  6. 06

    Privacy-sensitive data handling and user trust design

  7. 07

    Authentication with NextAuth, data modelling with Prisma

Languages

What it's written in

  • TypeScript / TSX~192 files

    application code

  • SQL

    schema and migrations

  • JavaScript

    config

Screens

More screens

Next project

Math Worksheets

A Django project for math worksheets