How to vibe codeBoomerang

Prerequisites

• Node.jsfree

  Required runtime for building the Next.js application and tooling.

• GitHubfree

  Source control and deployment pipeline integration.

• Google Cloud Console Accountfree

  Required to configure OAuth credentials and Gmail/Calendar API access for email syncing.

AI coding tools

• Claude Code

  Best-in-class coding agent for scaffolding full-stack applications, managing API routes, and writing complex background worker logic.

• Cursor

  Ideal AI-native editor for iterative frontend UI work on the dashboard and scheduling views.

Build guide

1. 01Project Scaffolding & Database Schema

   Initialize the Next.js application with Tailwind CSS, shadcn/ui components, Drizzle ORM, and Turso. Define database schemas for users, scheduled_emails, calendar_events, and tracking_logs.

   Create a new Next.js project using App Router and TypeScript. Install Tailwind CSS and configure shadcn/ui. Set up Drizzle ORM to connect to a Turso SQLite database over HTTP. Define the database schema with tables for users (id, email, oauth_tokens), scheduled_emails (id, user_id, recipient, subject, body, send_at, status), calendar_bookings (id, user_id, slot_start, slot_end, attendee_email, status), and tracking_logs (id, email_id, event_type, ip, timestamp). Ensure proper foreign key constraints and indexes on scheduled dates.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

2. 02Authentication & OAuth Integration

   Implement user authentication using better-auth and integrate Google/Microsoft OAuth scopes for Gmail and Calendar access.

   Configure better-auth in the Next.js application with email/password and Google OAuth providers. Request offline access and specific scopes for Gmail API (https://www.googleapis.com/auth/gmail.send, https://www.googleapis.com/auth/gmail.readonly) and Google Calendar API. Store encrypted OAuth access and refresh tokens securely in the user session and database. Build a settings page UI showing connection status for mail and calendar services.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

3. 03Send-Later & Durable Background Queue

   Set up Inngest to handle background job scheduling for emails queued to be sent at a future date.

   Integrate Inngest into the Next.js backend. Create a server action that accepts composed email details and a target 'send_at' timestamp, saves a record to the scheduled_emails table with status 'pending', and triggers an Inngest background function. The Inngest function should sleep until the 'send_at' time, verify the user's valid OAuth token, dispatch the email via the Gmail API, and update the database status to 'sent'. Handle token refresh failures and retry logic gracefully.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

4. 04Response Tracking & Inbox Reminders

   Implement tracking pixels for read receipts and background workers that check for replies to sent emails.

   Build an email tracking endpoint that injects a 1x1 transparent tracking pixel image URL (e.g., /api/track/[id]) into outgoing emails and wraps links for click tracking. When hit, record the event in tracking_logs. Create a scheduled cron job using Inngest that runs hourly to scan sent emails where 'return_if_no_reply' is set, query the Gmail API thread status for replies, and if no response is detected within the set timeframe, move the email back to the top of the user's inbox or send a reminder notification.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

5. 05Calendar Scheduling & Booking Links

   Build a bookable schedule interface where external users can select available time slots synced with Google Calendar.

   Create a public booking page route (/book/[username]) that fetches free/busy availability from the user's Google Calendar API for the next 14 days, respecting working hours and buffer times. Build a React component allowing visitors to select an open slot, enter their name and email, and confirm. Upon confirmation, the backend should create a calendar event via the Google Calendar API, send confirmation emails to both parties via Resend, and store the booking in the database.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

6. 06Respondable AI Assistant

   Integrate the Anthropic API to analyze draft emails and provide real-time feedback on tone, length, and reply probability.

   Build an API route /api/ai/respondable that accepts an email subject line and body text. Use the Anthropic SDK with Claude Haiku to analyze the text based on professional communication heuristics (subject length, question count, sentiment, readability score) and return a JSON object containing a predicted reply probability percentage and actionable improvement suggestions. Integrate this into the email compose dashboard view as a live sidebar metric.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

7. 07Dashboard UI & Polish

   Construct the main web dashboard to manage scheduled emails, active response tracking, inbox pause rules, and calendar settings.

   Build a polished dashboard UI using shadcn/ui components with tabs for 'Scheduled', 'Tracking', 'Inbox Pause', and 'Calendar Settings'. Implement data tables with sorting, filtering, and bulk actions for pending scheduled emails. Add an 'Inbox Pause' toggle switch that updates database rules to hold incoming webhook notifications from Gmail when enabled. Ensure responsive design, loading skeletons, and error toast notifications throughout.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

Cost vs paying for Boomerang