Wraps README

Deploy email infrastructure to your AWS account in under 2 minutes.

Quick Start

Prerequisites: Node.js 22+, AWS credentials configured

# Deploy email infrastructure to your AWS account
npx @wraps.dev/cli email init

# Install the SDK
pnpm add @wraps.dev/email

import { WrapsEmail } from '@wraps.dev/email';

const email = new WrapsEmail();

const { messageId } = await email.send({
  from: 'hello@yourapp.com',
  to: 'user@example.com',
  subject: 'Welcome!',
  html: '<h1>Hello from Wraps!</h1>',
});

console.log('Sent:', messageId);

For AI Agents

Using Claude Code, Cursor, or another AI assistant? Point it at:

• wraps.dev/llms-full.txt — the complete Wraps documentation in one file (quickstarts, SDK reference, CLI reference, guides)
• wraps.dev/llms.txt — agent-oriented index: when to use Wraps, quick command reference, links to everything
• Claude Code skills — installable from wraps.dev/.well-known/skills/
• MCP server — hosted at https://wraps.dev/mcp, or run locally with npx -y @wraps.dev/mcp for tools that send email, check setup status, and read event logs (reference)

Why Wraps?

• You own it — Infrastructure deploys to your AWS account. Data never leaves your cloud. If we disappeared tomorrow, your email keeps working.
• 2-minute setup — One CLI command. No AWS console spelunking. No 1000-word sandbox approval essays.
• AWS pricing — Pay AWS directly for sending. No middleman markup. Scale affordably.
• Real DX — TypeScript SDK, visual templates, real-time analytics, interactive dashboard.

What Gets Deployed

One command creates all of this in your AWS account:

• SES — Domain verification, DKIM, SPF, DMARC
• EventBridge + SQS — Real-time event tracking (bounces, opens, clicks, deliveries)
• DynamoDB — Email event history with configurable retention
• Lambda — Event processing and webhook handling
• IAM — Least-privilege roles with OIDC support (Vercel, AWS native)

All resources are namespaced under wraps- (most as wraps-email-*) and tagged ManagedBy: wraps-cli.

Also Available

Documentation

Community

• GitHub Issues — Bug reports and feature requests
• GitHub Discussions — Questions and ideas
• Contributing — Development setup and guidelines

License

AGPL-3.0 — see LICENSE for details. Enterprise features under commercial license. See wraps.dev for more information.