Skip to content
Browse documentation
typescript sdk

Configure SMTP

Connect a verified TLS relay or explicitly local development capture without exposing credentials.

Use a server-owned relay

import { createSmtpEmailAdapter } from "@smoothie-framework/email-smtp";

export function createRelay(user: string, pass: string) {
  return createSmtpEmailAdapter({
    host: "smtp.example.com",
    port: 587,
    security: "starttls",
    auth: { user, pass },
  });
}

Load credentials on the server. starttls requires the upgrade; tls uses implicit verified TLS. Certificate verification cannot be disabled. Bound the send deadline for your deployment.

Capture development messages locally

local-plaintext is limited to supported loopback/local development hosts without credentials. It is not a remote production mode. Use a local mailbox such as Mailpit to inspect messages without sending to real recipients.

The adapter bounds delivery and projects safe outcomes; SMTP remains a remote side effect. Stable Message-ID can help duplicate handling, but cannot guarantee exactly-once delivery. Remote TLS and inbox behavior need deployment-specific checks.