email-best-practices

작성자: resend

전달 가능하고, 규정을 준수하며 사용자 친화적인 이메일 시스템 구축을 위한 종합 가이드입니다. 인증 설정(SPF/DKIM/DMARC), 스팸 문제 해결, 이메일이 스팸함에 들어가지 않도록 하는 전달성 모범 사례를 다룹니다. 비밀번호 재설정, OTP, 확인 이메일과 같은 트랜잭션 이메일과 적절한 동의 워크플로우를 갖춘 마케팅 이메일을 위한 템플릿과 패턴을 포함합니다. CAN-SPAM, GDPR, CASL 규정 준수 프레임워크와 더블 옵트인 및 차단 목록 관리를 제공합니다.

npx skills add https://github.com/resend/email-best-practices --skill email-best-practices

Email Best Practices

Guidance for building deliverable, compliant, user-friendly emails.

Architecture Overview

[User] → [Email Form] → [Validation] → [Double Opt-In]
                                              ↓
                                    [Consent Recorded]
                                              ↓
[Suppression Check] ←──────────────[Ready to Send]
        ↓
[Idempotent Send + Retry] ──────→ [Email API]
                                       ↓
                              [Webhook Events]
                                       ↓
              ┌────────┬────────┬─────────────┐
              ↓        ↓        ↓             ↓
         Delivered  Bounced  Complained  Opened/Clicked
                       ↓        ↓
              [Suppression List Updated]
                       ↓
              [List Hygiene Jobs]

Quick Reference

Need to...See
Set up SPF/DKIM/DMARC, fix spam issuesDeliverability
Build password reset, OTP, confirmationsTransactional Emails
Plan which emails your app needsTransactional Email Catalog
Build newsletter signup, validate emailsEmail Capture
Send newsletters, promotionsMarketing Emails
Ensure CAN-SPAM/GDPR/CASL complianceCompliance
Decide transactional vs marketingEmail Types
Handle retries, idempotency, errorsSending Reliability
Process delivery events, set up webhooksWebhooks & Events
Manage bounces, complaints, suppressionList Management
Make emails accessible (screen readers, alt text, contrast)Accessibility

Start Here

New app? Start with the Catalog to plan which emails your app needs (password reset, verification, etc.), then set up Deliverability (DNS authentication) before sending your first email.

Spam issues? Check Deliverability first—authentication problems are the most common cause. Gmail/Yahoo reject unauthenticated emails.

Marketing emails? Follow this path: Email Capture (collect consent) → Compliance (legal requirements) → Marketing Emails (best practices).

Production-ready sending? Add reliability: Sending Reliability (retry + idempotency) → Webhooks & Events (track delivery) → List Management (handle bounces).

Accessibility? Most emails fail basic accessibility checks. See Accessibility for lang/dir, presentational tables, headings, alt text, <title>, and contrast.

resend의 다른 스킬

send-email
resend
트랜잭션 및 대량 이메일 전송을 Resend API를 통해 단일 또는 배치 엔드포인트로 제공합니다. 개별 이메일(첨부 파일 또는 예약 포함)에는 단일 엔드포인트를 사용하고, API 호출을 줄이기 위해 한 번의 요청으로 2~100개의 개별 이메일을 보낼 때는 배치 엔드포인트를 사용하세요. 멱등성 키(<event-type>/<entity-id> 형식)를 구현하여 재시도 시 중복 전송을 방지하며, 24시간 만료됩니다. 429(속도 제한) 및 500(서버 오류) 응답에 대해서만 지수 백오프를 사용하여 재시도하고, 400/422 유효성 검사 오류는 재시도 없이 수정하세요.
templates
resend
API를 통해 Resend 이메일 템플릿을 생성, 업데이트, 게시, 삭제하거나 나열할 때, 또는 템플릿 변수를 정의하거나 초안과 최종본의 차이를 이해할 때 사용합니다.
design-audit
resend
Resend 대시보드의 디자인 시스템 정합성을 감사합니다. 사용자가 "디자인 감사", "디자인 정합성", "대시보드 디자인 감사"라고 말하거나…에 대해 물을 때 여기로 라우팅됩니다.
marketing-pages
resend
Resend 코드베이스에서 마케팅/공개 페이지를 생성, 업데이트, 편집 또는 삭제할 때 사용합니다. 페이지 구조, 컴포넌트 재사용 규칙, 그리고 그…
resend-design-skills
resend
Resend 디자인 리소스가 필요할 때 사용합니다. 브랜드 가이드라인, 시각적 아이덴티티, UI 컴포넌트, 디자인 토큰 및 마케팅 페이지 패턴으로 연결됩니다.
resend-design-system
resend
Resend 코드베이스에서 UI를 구축하거나 수정할 때 사용합니다. 모든 src/ui/…에 대한 컴포넌트 API, 변형 옵션, 디자인 토큰, 구성 패턴을 제공합니다.
react-email
resend
React 컴포넌트를 사용하여 클라이언트 안전 스타일링과 미리보기 테스트가 포함된 HTML 이메일을 빌드하고 전송합니다. TypeScript를 지원하는 컴포넌트 기반 이메일 개발로, 핵심 레이아웃 컴포넌트(Html, Body, Container, Section, Row, Column)와 콘텐츠 요소(Heading, Text, Button, Image, CodeBlock)를 제공합니다. Tailwind 컴포넌트를 통한 Tailwind CSS 스타일링(픽셀 기반 프리셋 사용)과 이메일 클라이언트 호환성을 위한 테이블 기반 레이아웃이 필요합니다. 로컬 개발 서버에서 localhost:3000에서 미리보기 및 실시간 편집을 지원합니다.
resend-migrate
resend
SendGrid, Mailgun 또는 Postmark에서 Resend로 마이그레이션할 때 사용 - @sendgrid/mail, sgMail, SENDGRID_API_KEY, mailgun, postmark 임포트를 감지하여 라우팅합니다…