工程开发
react-email avatar

react-email

使用 React 组件构建并发送响应式 HTML 电子邮件模板。提供可视化编辑器、渲染引擎,并与各大电子邮件客户端兼容。

简介

React Email 是一个强大且现代化的框架,旨在简化跨客户端电子邮件开发的复杂性。它使开发人员能够使用熟悉的 React 语法构建精美、响应式的电子邮件模板,免除了编写过时的基于表格的 HTML 结构的麻烦。通过抽象化 Gmail、Outlook 和 Apple Mail 等电子邮件客户端之间的不一致性,团队可以专注于设计和内容,同时确保在不同平台上呈现一致。

  • 基于组件的架构,使用 Html、Body、Container、Row、Column 和 Section 等专业原件来可靠地管理布局。
  • 通过专用组件提供集成的 Tailwind CSS 支持,实现针对电子邮件客户端限制进行优化的像素级实用程序样式。
  • 内置具备热重载功能与浏览器预览界面的开发服务器,加速模板设计的迭代。
  • 基于 Tiptap 和 ProseMirror 的可嵌入式可视化电子邮件编辑器,用于内容管理与无代码模板修改。
  • 强大的渲染引擎,可将 JSX/React 组件转换为适合注入任何 SMTP 服务或电子邮件 API 的原生 HTML 字符串。
  • 全面的兼容性层,自动处理不同电子邮件客户端的特定标记需求。

使用说明与最佳实践包含:

  • 使用提供的 CLI 工具 (npx create-email) 来构建项目并在组织良好的目录结构中管理电子邮件模板。
  • 在开发前务必确定品牌颜色、标志托管 (CDN) 以及样式偏好以确保一致性。
  • 图片应托管在生产就绪的 CDN 上;使用环境感知 URL 模式在本地开发资源与生产环境 URL 之间切换。
  • 避免使用支持度不佳的 CSS 功能(如媒体查询),应改用框架推荐的布局组件。
  • 请勿直接在 JSX 组件中使用模板变量 (例如 {{variableName}});应通过组件 props 传递,并在测试时使用 PreviewProps 模式。
  • 通过渲染为 HTML 并将结果传递给相关的 API,与 Resend、Nodemailer、SendGrid、Mailgun、AWS SES 或 Postmark 等热门交易型邮件服务供应商进行整合。
  • 此工具非常适合用于构建欢迎信、密码重置通知、订单确认、电子报及复杂的交易通知。

仓库统计

Star 数
19,084
Fork 数
1,036
Open Issue 数
81
主要语言
TypeScript
默认分支
main
同步状态
空闲
最近同步时间
2026年5月3日 05:56
在 GitHub 查看