Knotable Props Mailer – V2

Next.js 15 + Supabase implementation of the Props email console. The legacy Meteor codebase has been removed so this repository now mirrors the Vercel deploy target one-to-one.

Stack

• Next.js App Router + Tailwind for the dashboard UI
• Supabase Postgres/Auth/Storage for drafts, lists, and attachments
• Amazon SES (SMTP) for outbound mail; future SNS webhooks will feed stats back into Supabase

Local development

1. Copy .env.example to .env.local and fill in Supabase + SES values.
2. Run the dev server:

   npm install
   npm run dev

3. Open http://localhost:3000 – root redirects to /email/composer.

Required environment variables

• NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY – Supabase project settings › API
• SUPABASE_SERVICE_ROLE_KEY, SUPABASE_JWT_SECRET – used by Supabase migrations / server actions
• AWS_SES_SMTP_USERNAME, AWS_SES_SMTP_PASSWORD, AWS_SES_SMTP_ENDPOINT, AWS_SES_SMTP_PORT – SMTP credentials for SES
• APP_BASE_URL – e.g. https://props-v2.vercel.app for app-generated links and internal callbacks

Database

SQL schema lives in supabase/schema.sql. Apply it to your Supabase instance, enable Row Level Security, and create policies restricting tables to the single admin role.

Deploying to Vercel

1. Create a new Vercel project pointing at the repo root (auto-detected as Next.js).
2. Add the env vars above in the Vercel dashboard.
3. Deploy without any Vercel Cron jobs. Queued emails are reviewed and sent manually from the Queue page.
4. (Optional) Wire SES → SNS → Supabase to capture engagement metrics.

Directory map

• src/app/(auth) – passwordless login screen for email sign-in codes
• src/app/(dashboard) – Composer, Schedule, Analytics, Lists, Users tabs
• src/lib – env helper, Supabase factories, SES SMTP client
• supabase/schema.sql – Postgres schema
• docs/ – roadmap, data model, and the legacy README for reference

Outstanding work

• Wire Supabase auth session into layouts/middleware for route protection
• Expand queue review tooling and delivery safeguards
• Expand SES deliverability reporting and large-send operator runbooks
• Style tweaks to perfectly match legacy Props UI