Email

Email lives in @repo/mail, governed by config.email in packages/config/src/index.ts. There is no enabled flag - mail is always wired; config.email.provider selects the vendor and every send is queued through a background worker.

Providers

config.email.provider is baked in at init and switchable any time. getEmailProvider() loads lazily, so only the selected SDK runs.

• EMAIL_PROVIDER overrides config.email.provider per environment when set, so a staging deploy can use a different vendor than the committed choice.
• Local capture: run pnpm infra for Mailpit, set SMTP_HOST=localhost and SMTP_PORT=1025, then read mail at http://localhost:8025.

Sending

Two entry points are exported from @repo/mail. Both return immediately - the provider send() runs in the send-email worker with three retries (see Background jobs).

import { sendEmail, sendTemplateEmail } from "@repo/mail";

// Raw HTML/text - fires an `email/send` event, returns immediately.
await sendEmail({ to, from, subject, html /* , text, replyTo, headers */ });

// Renders a React Email template, picks the sender, adds marketing unsubscribe headers when needed, then queues.
await sendTemplateEmail({
  to,
  subject,
  templateData: { template: "welcome", props: { /* typed per template */ } }
});

• Every send is logged and checked against the suppression list before the provider call - bounced addresses get nothing, complaining ones get no marketing. See Email deliverability.
• config.email.limitPerSecond (default 3) throttles the worker - raise it for high-volume providers.
• from is optional on sendTemplateEmail (auto-selected), required on sendEmail.

Sender identities

config.email.senders defines three identities ({ email, senderName }); marketing additionally requires signatureName. sendTemplateEmail picks one from the template's email class, not its visual layout.

• Founder-style templates serialize to the markup a mail-client composer produces for a hand-typed message - no layout chrome, preheader, tables, or tooling artifacts - so they land in the primary inbox tab instead of promotions. They carry List-Unsubscribe / List-Unsubscribe-Post headers when their props include an unsubscribeUrl.
• marketing.signatureName signs every founder-style email and fills the welcome introduction. Replace the generated placeholder before going live.

Templates

Templates are React Email components in packages/mail/src/templates/, each a member of the TemplateEmailType discriminated union in packages/mail/src/types.ts. Preview them with pnpm dev:mail (port 3030).

Add a template

Writing marketing emails

Short, plain emails get opened and answered; long ones read like a campaign. The shipped lifecycle emails follow these rules - keep them when you edit those or write an announcement.

Re-engagement

config.email.inactiveEmailSchedule (default [7, 30, 90]) lists day-thresholds since a user's lastActiveAt. The daily inactive-user-check cron (0 10 * * *) finds marketing-opted-in users idle past the threshold for their current inactiveEmailLevel; the we-miss-you function sends level-aware copy and increments the level.

Newsletter

Bulk list sync is gated by config.newsletter - { enabled: false } | { enabled: true; provider: "resend" | "listmonk" }. Generated projects ship { enabled: false }; subscription is the marketingOptIn auth field (defaultValue: true), not a separate form.