VibeMail

AI-powered email marketing for developers. Build email campaigns with natural language - powered by Claude AI.

Quick Start

``bash


Install globally

npm install -g vibemail

Or use with npx

npx vibemail
`

Usage

$3

- Login to vibemail.com
- Go to Settings → API Keys
- Create a new API key

$3

`bash
export VIBEMAIL_API_KEY="vb_your-api-key-here"
`

$3

`bash
vibemail create "welcome email series for new SaaS users"
`

$3

`bash

Use local dev server (no API key needed)

VIBEMAIL_API_URL=http://localhost:3000 vibemail create "your campaign"
`

Features

- 🤖 Natural language campaign creation
- 📧 Multi-email sequences
- 🎯 Smart audience targeting
- 📊 Analytics and tracking
- 🚀 One-command deployment

Web App

Visit vibemail.com for the full web experience.

Development Setup

`
vibemail-app/
├── app/ # Next.js App Router
│ ├── api/ # API endpoints
│ ├── auth/ # Authentication pages
│ ├── dashboard/ # Dashboard pages
│ └── page.tsx # Landing page
├── components/ # React components
├── emails/ # React Email templates
├── lib/ # Core business logic
│ ├── ai/ # Claude AI integration
│ ├── email/ # Email sending logic
│ ├── stripe/ # Payment processing
│ └── supabase/ # Database client
└── supabase/ # Database migrations
`

$3

`bash


Install dependencies

npm install

Run development server

npm run dev

Build for production

npm run build

Start production server

npm start

Run linter

npm run lint
`

$3

Create a .env.local file with:
`
ANTHROPIC_API_KEY=your-key
DATABASE_URL=your-neon-db-url
CLERK_SECRET_KEY=your-clerk-key
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your-clerk-pub-key
MAILGUN_API_KEY=your-mailgun-key
`

📚 Architecture

- Authentication: Clerk for user management
- Database: Neon (Postgres) with Drizzle ORM
- AI: Claude API for campaign generation
- Email: Mailgun for sending and tracking
- Hosting: Vercel for web app and API

🌐 API Endpoints

- POST /api/v2/campaigns/generate - Generate AI campaign
- POST /api/v2/campaigns/deploy - Deploy campaign
- POST /api/webhooks/mailgun - Email event tracking
- GET /api/analytics` - Campaign analytics

Documentation

See vibemail.com/docs for complete documentation.

License

MIT