Deploy email infrastructure to your AWS account in under 2 minutes.
---
## Quick Start
**Prerequisites:** Node.js 22+, AWS credentials configured
```bash
# Deploy email infrastructure to your AWS account
npx @wraps.dev/cli email init
```
```bash
# Install the SDK
pnpm add @wraps.dev/email
```
```typescript
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: 'Hello from Wraps!
',
});
console.log('Sent:', messageId);
```
## For AI Agents
Using Claude Code, Cursor, or another AI assistant? Point it at:
- **[wraps.dev/llms-full.txt](https://wraps.dev/llms-full.txt)** — the complete Wraps documentation in one file (quickstarts, SDK reference, CLI reference, guides)
- **[wraps.dev/llms.txt](https://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/](https://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](https://wraps.dev/docs/mcp-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
| Service | CLI | SDK |
|---------|-----|-----|
| **SMS** (AWS End User Messaging) | `wraps sms init` | [`@wraps.dev/sms`](https://www.npmjs.com/package/@wraps.dev/sms) |
| **CDN** (S3 + CloudFront) | `wraps cdn init` | — |
| **Email (Python)** | — | [`wraps-email`](https://pypi.org/project/wraps-email/) |
| **Platform API client** | — | [`@wraps.dev/client`](https://www.npmjs.com/package/@wraps.dev/client) |
| **MCP server** | — | [`@wraps.dev/mcp`](https://www.npmjs.com/package/@wraps.dev/mcp) |
| **CDK construct** | — | [`@wraps.dev/cdk`](https://www.npmjs.com/package/@wraps.dev/cdk) |
| **Pulumi component** | — | [`@wraps.dev/pulumi`](https://www.npmjs.com/package/@wraps.dev/pulumi) |
## Documentation
| Resource | Link |
|----------|------|
| Quickstart | [wraps.dev/docs/quickstart](https://wraps.dev/docs/quickstart) |
| CLI Reference | [wraps.dev/docs/cli-reference](https://wraps.dev/docs/cli-reference) |
| SDK Reference | [wraps.dev/docs/sdk-reference](https://wraps.dev/docs/sdk-reference) |
| Python SDK Reference | [wraps.dev/docs/python-sdk-reference](https://wraps.dev/docs/python-sdk-reference) |
| MCP Reference | [wraps.dev/docs/mcp-reference](https://wraps.dev/docs/mcp-reference) |
| Guides | [wraps.dev/docs/guides](https://wraps.dev/docs/guides) |
| Infrastructure | [wraps.dev/docs/infrastructure](https://wraps.dev/docs/infrastructure) |
| Complete docs for LLMs | [wraps.dev/llms-full.txt](https://wraps.dev/llms-full.txt) |
## Community
- [GitHub Issues](https://github.com/wraps-team/wraps/issues) — Bug reports and feature requests
- [GitHub Discussions](https://github.com/wraps-team/wraps/discussions) — Questions and ideas
- [Contributing](CONTRIBUTING.md) — Development setup and guidelines
## License
AGPL-3.0 — see [LICENSE](LICENSE) for details. Enterprise features under commercial license. See [wraps.dev](https://wraps.dev) for more information.