VibeMail

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

Quick Start

# Install globally
npm install -g vibemail

# Or use with npx
npx vibemail

Usage

1. Get your API key from VibeMail dashboard:

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

2. Set your API key:

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

3. Create a campaign:

vibemail create "welcome email series for new SaaS users"

Local Development:

# 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

🚀 Local Development

# 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

🔧 Configuration

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