How to vibe codeSaneBox

Prerequisites

• Node.jsfree

  Runtime environment for the backend worker and automation scripts

• GitHubfree

  Source control and deployment pipeline integration

• Google Cloud / Azure Developer Accountfree

  Required to configure OAuth2 credentials and API scopes for mailbox access

AI coding tools

• Claude Code

  Agentic terminal coding tool best suited for orchestrating backend IMAP workers and database schemas

• Cursor

  AI code editor for refining classification algorithms and webhook routing logic

Build guide

1. 01Project Scaffolding & Database Schema

   Initialize the Next.js project with Turso database connectivity, user models, and encrypted OAuth token storage tables.

   Initialize a new Next.js project using TypeScript and Tailwind CSS. Set up Turso for database access using Drizzle ORM. Create the database schema tables: users (id, email, created_at), accounts (id, user_id, provider, access_token_encrypted, refresh_token_encrypted, token_expires_at), and email_logs (id, user_id, message_id, sender, subject, date, action_taken). Ensure all environment variables for Turso and encryption keys are correctly typed and validated using Zod. Write comprehensive unit tests for the database connection and model operations.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

2. 02OAuth2 Authentication Integration

   Implement OAuth2 authorization flows for Gmail and Microsoft 365 with secure credential encryption.

   Implement OAuth2 authentication routes for Google and Microsoft 365 using standard Node.js authentication libraries. Store the resulting refresh and access tokens securely in the Turso database using AES-256 encryption. Build a robust token refresh mechanism that automatically exchanges expired access tokens using stored refresh tokens before any IMAP connection attempt. Include error handling for revoked grants and clear user re-authentication prompts in the Next.js dashboard.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

3. 03IMAP Connection & Folder Sync Engine

   Build the core backend worker capable of connecting to mail servers via IMAP, creating custom folders, and monitoring messages.

   Build a background worker service in Node.js utilizing an IMAP client library (such as node-imap) to connect securely to mail servers using XOAUTH2 credentials. Implement routines that automatically verify and create target folders ('@SaneLater', '@SaneBlackHole') upon initial sync. Set up IMAP IDLE listeners or polling mechanisms to detect incoming messages in the Inbox folder in real time without blocking the main event loop. Handle connection drops and automatic reconnections gracefully.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

4. 04Header Classification & Routing Logic

   Develop the heuristic engine that parses email headers (sender, subject, interaction history) to decide whether to move messages.

   Develop an email classification module that evaluates incoming email headers (sender address, subject keywords, date, and historical interaction frequency stored in Turso). If an email is determined to be low-value or from an unknown sender, program the IMAP engine to move the message from the 'INBOX' folder to the '@SaneLater' folder. Implement a training endpoint so that when a user manually moves an email back to the inbox from '@SaneLater', the system updates sender heuristics and updates the database state accordingly.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

5. 05BlackHole & Snooze Features

   Add support for permanently blocking senders via SaneBlackHole and postponing messages via SaneSnooze.

   Implement the SaneBlackHole feature: when an email is dragged into the '@SaneBlackHole' folder, parse the sender address, store it in a blocked_senders table, and automatically delete or archive future messages from that sender. Implement the SaneSnooze feature using background cron jobs (via Inngest) to move selected emails out of the inbox into a temporary folder and return them to the primary inbox at a scheduled timestamp.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

6. 06Daily Digest & Dashboard UI

   Create the user dashboard and automated email digest summarizing filtered messages.

   Build a Next.js dashboard displaying connected email accounts, recent filter activity logs, and manual training controls. Implement an automated daily cron job that compiles a summary of emails moved to '@SaneLater' over the past 24 hours and dispatches a Daily Digest email to the user using Resend. Ensure the dashboard UI is clean, responsive, and styled with Tailwind CSS.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

Cost vs paying for SaneBox