https://github.com/wraps-team/wraps
AWS Email, SMS, & CDN, simple.
https://github.com/wraps-team/wraps
aws cdn cli email ses sms typescript
Last synced: about 2 months ago
JSON representation
AWS Email, SMS, & CDN, simple.
- Host: GitHub
- URL: https://github.com/wraps-team/wraps
- Owner: wraps-team
- License: other
- Created: 2025-11-07T21:19:46.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-04-03T20:14:10.000Z (3 months ago)
- Last Synced: 2026-04-03T22:34:01.353Z (3 months ago)
- Topics: aws, cdn, cli, email, ses, sms, typescript
- Language: TypeScript
- Homepage: https://wraps.dev
- Size: 165 MB
- Stars: 33
- Watchers: 2
- Forks: 4
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
Deploy email infrastructure to your AWS account in under 2 minutes.
---
## Quick Start
**Prerequisites:** Node.js 20+, 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);
```
## 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 with `wraps-email-*` and tagged `ManagedBy: wraps-cli`.
## Also Available
| Service | CLI | SDK |
|---------|-----|-----|
| **SMS** | `wraps sms init` | [`@wraps.dev/sms`](https://www.npmjs.com/package/@wraps.dev/sms) |
| **CDK** | — | [`@wraps.dev/cdk`](https://www.npmjs.com/package/@wraps.dev/cdk) |
| **Pulumi** | — | [`@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) |
| Guides | [wraps.dev/docs/guides](https://wraps.dev/docs/guides) |
| Infrastructure | [wraps.dev/docs/infrastructure](https://wraps.dev/docs/infrastructure) |
## 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.