Resend Email

Setup

npm install resend
npm install @react-email/components

Sending Emails

import { Resend } from 'resend';
import { WelcomeEmail } from '@/emails/welcome';

const resend = new Resend(process.env.RESEND_API_KEY);

// Plain text
await resend.emails.send({
  from: 'App <no-reply@yourdomain.com>',
  to: ['user@example.com'],
  subject: 'Welcome',
  html: '<p>Your account is ready.</p>',
});

// With React Email template
await resend.emails.send({
  from: 'App <no-reply@yourdomain.com>',
  to: ['user@example.com'],
  subject: 'Welcome',
  react: WelcomeEmail({ name: 'Alice' }),
});

React Email Templates

Template pattern and webhook handler examples: see REFERENCE.md.

Preview Templates

npx email dev

Domain Configuration

1. Add your domain at resend.com → Domains
2. Configure DNS records (SPF, DKIM, DMARC) and await verification (<1h)
3. Post-verify: send one canned test to postmaster@ and confirm headers (SPF/DKIM pass).
4. Use from: 'Name <no-reply@yourdomain.com>' in sends

Webhook Handling

Webhook handling patterns and a safe, verified handler example are in REFERENCE.md (this directory).

Quick Verification Workflow

1. Add domain and copy DNS records.
2. Verify DNS propagation: dig TXT yourdomain.com — confirm SPF/DKIM records appear.
3. Send a test email and confirm SPF/DKIM pass in headers.
4. Deploy webhook handler; test with: curl -X POST -H 'Content-Type: application/json' -d '{"type":"email.delivered"}' https://yourapp.com/api/webhooks/resend — assert 200.
5. If verification fails: re-check DNS, API keys, and webhook secret.

See REFERENCE.md for detailed verification commands and troubleshooting.