Introduction
The @frame/mail package manages the full lifecycle of email communications in the FRAME ecosystem. From visual template design to SMTP transport logic, it ensures that all notifications (transactional and marketing) reach users reliably with a consistent aesthetic.
Overview
Section titled “Overview”Historically, HTML email template design depended on archaic markup and nested tables that were hard to maintain. This module modernizes that approach with React.
[!TIP] Design Componentization With React Email, we can reuse components, inject type-safe variables, and apply visual logic declaratively — just as we would in the web app (
apps/next).
Core Technologies
Section titled “Core Technologies”The email infrastructure rests on two technological pillars:
- React Email (v6): Base framework that provides a collection of primitive components (buttons, containers, typography) designed for compatibility with the vast majority of email clients.
- Nodemailer: The de facto Node.js standard for sending email, used as the underlying SMTP transport layer.
Roles in the Ecosystem
Section titled “Roles in the Ecosystem”This package operates behind the scenes as a service provider. Its primary relationships are with:
| Consumer | Integration Reason |
|---|---|
apps/nest | Injects transporter configuration and templates to send receipts, alerts, or notifications driven by business logic. |
apps/next | (Occasionally) for Edge Runtime processes and lightweight confirmations triggered via Server Actions. |
@frame/auth | Provides registration confirmation and password-reset templates. |
To learn about creating new templates and the internal structure, go to Logical Architecture.