用途:为 NodeJS-Starter-V1 项目提供响应式事务性邮件模板模式,适用于欢迎邮件、密码重置、告警、定时任务报告、智能体告警等通知邮件,并用于搭建邮件发送基础设施(Resend、SMTP、SendGrid)以及邮件预览与测试工具。
主要能力:基于 React Email 组件与 Resend 发送 API;提供 Scientific Luxury 深色主题邮件设计(深色背景、光谱色强调、直角、等宽数据值);提供 EmailLayout 基础布局与 EmailHeader、EmailButton、EmailFooter 等共享组件;内置 daily-report 等示例模板;支持 React Email 预览服务器与程序化渲染(@react-email/render)用于测试;集成 /api/cron/daily-report 定时任务与通知流程;支持 en-AU 本地化(日期 DD/MM/YYYY、AUD 货币、AEST/AEDT 时区、澳式拼写)。
必要用法:安装依赖 pnpm add @react-email/components、pnpm add -D react-email、pnpm add resend;模板放在 apps/web/emails/,发送工具放在 apps/web/lib/email/;通过 sendEmail() 统一发送,收件人使用 REPORT_EMAIL_RECIPIENTS 环境变量;预览执行 pnpm email:dev(--dir apps/web/emails --port 3001)。邮件须使用 table 布局与内联样式,避免 CSS Grid/Flexbox 和外部 style 块,所有图片加 alt,发送前必须预览。
适用场景:事务邮件、通知邮件、定时报告、系统告警及深色品牌一致的邮件体验。
限制:资料未提供具体价格、收费、性能数据与官方支持信息;不同邮件客户端对深色模式支持不一致,部分客户端强制浅色主题,需设计回退;不适用于应用内 toast、Slack/Webhook 通知、PDF 报告生成或 CSV 数据导入处理,这些应使用对应的 UI 组件、webhook-handler、pdf-generator、csv-processor 模式。