Deploy production-ready email infrastructure to your AWS account in under 2 minutes and send your first email.
Every command below runs against your AWS account. Before running anything, make sure you have:
AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables, a configured profile via aws configure, or an active aws sso login session# Option A: environment variablesexport AWS_ACCESS_KEY_ID=AKIA...export AWS_SECRET_ACCESS_KEY=...export AWS_REGION=us-east-1# Option B: AWS CLI profileaws configure# Option C: AWS SSOaws sso loginMissing credentials fail after the first prompt
If credentials aren't configured, the CLI still starts and asks its telemetry question before failing with a credentials error. Set up credentials first to avoid the confusing dead end.
What you'll build
Time: ~2 minutes
Run the Wraps CLI to deploy email infrastructure to your AWS account:
npx @wraps.dev/cli email initWhat happens during deployment?
Install the @wraps.dev/email package:
npm install @wraps.dev/email
Create a new file and send an email using the SDK:
import { WrapsEmail } from '@wraps.dev/email';// Initialize the clientconst wraps = new WrapsEmail();// Send an emailconst result = await wraps.send({ from: 'hello@yourdomain.com', to: 'user@example.com', subject: 'Welcome to Wraps!', html: '<h1>Hello from Wraps!</h1><p>This email was sent using AWS SES.</p>',});if (result.success) { console.log('Email sent:', result.data.messageId);} else { console.error('Failed to send email:', result.error);}Note: Domain Verification
Before sending emails, you need to verify your domain with AWS SES. Run npx @wraps.dev/cli email domains verify -d yourdomain.com to check your DNS records and get setup instructions.
Run the local dashboard to view email analytics and event tracking:
npx @wraps.dev/cli dashboardThe dashboard will open at http://localhost:5555 where you can view email history, delivery rates, bounces, complaints, and more.
Learn about all available methods, options, and advanced features.
View SDK DocsExplore all CLI commands for managing your infrastructure.
View CLI Docs