# SMS Quickstart

Deploy production-ready SMS infrastructure to your AWS account and send your first text message.

## What You'll Build

- AWS End User Messaging with a provisioned phone number
- Automatic opt-out management for compliance
- Your first SMS sent via the TypeScript SDK

Time: ~3 minutes

## Prerequisites

- Node.js 20 or later
- An AWS account with valid credentials configured
- AWS CLI installed and configured

## Step 1: Deploy Infrastructure

```bash
npx @wraps.dev/cli sms init
```

Provisions a toll-free number, sets up AWS End User Messaging, and deploys IAM roles for OIDC authentication. Takes ~3 minutes.

## Step 2: Install the SDK

```bash
npm install @wraps.dev/sms
# or: pnpm add @wraps.dev/sms | yarn add @wraps.dev/sms | bun add @wraps.dev/sms
```

## Step 3: Send Your First SMS

```typescript
import { WrapsSMS } from '@wraps.dev/sms';

const sms = new WrapsSMS();

const result = await sms.send({
  to: '+14155551234',
  message: 'Your verification code is 123456',
});

console.log('SMS sent:', result.messageId);
```

> **Phone Number Format**: Numbers must be in E.164 format (e.g., `+14155551234`).

## Next Steps

- [SMS SDK Reference](https://wraps.dev/docs/sms-sdk-reference)
- [CLI Reference](https://wraps.dev/docs/cli-reference)
- [SMS Infrastructure](https://wraps.dev/docs/infrastructure/sms)
- [CDK Reference](https://wraps.dev/docs/cdk-reference) / [Pulumi Reference](https://wraps.dev/docs/pulumi-reference)