Introduction

mailshot is a serverless email sequencing framework on AWS, designed so that a single person can create, deploy, manage, and query email sequences entirely through AI (Claude Code) at near-zero cost.

The core idea: describe what you want in natural language, and Claude Code handles the rest - generating sequence configs, rendering templates, deploying infrastructure, managing subscribers, and monitoring delivery. No dashboard, no SaaS fees. AI creates the structured flow, you review and deploy.

How it works

Your app backend
    │
    │  publishes events
    ▼
EventBridge ──→ Step Functions ──→ SendEmailFn ──→ SES
                                       │
                                  S3 (templates)
                                  DynamoDB (state)

1. Your app publishes an event (e.g., customer.created) to EventBridge
2. An EventBridge rule starts a Step Functions state machine
3. The state machine walks through send/wait/choice/condition steps
4. Each send step invokes a Lambda that fetches a template from S3, renders it with LiquidJS, and sends via SES
5. Bounces, complaints, opens, clicks, and deliveries are tracked automatically

Everything is defined in code, deployed with CDK, and managed through Claude Code.

Documentation