Skip to content

email-templates.md

Latest commit

 

History

History
90 lines (69 loc) · 2 KB

email-templates.md

File metadata and controls

90 lines (69 loc) · 2 KB
Raw

Email Templates

Customize verification, password reset, and magic link emails.

Email Functions

Located in packages/auth/src/email/:

File Purpose
send-verification-email.ts Email verification
send-reset-password.ts Password reset
send-magic-link.ts Magic link login
send-invitation.ts Org invitations

Configuration in auth.ts

Verification Email

emailVerification: {
  sendOnSignUp: true,
  autoSignInAfterVerification: true,
  sendVerificationEmail: async ({ user, url }) => {
    const verificationUrl = buildEmailUrlWithFrontendCallback(url, "/dashboard");
    await sendVerificationEmail(env, {
      to: { address: user.email, name: user.name || "" },
      url: verificationUrl,
    });
  },
},

Password Reset

emailAndPassword: {
  sendResetPassword: async ({ user, url }) => {
    const resetUrl = buildPasswordResetFrontendUrl(url);
    await sendResetPassword(env, {
      to: { address: user.email, name: user.name || "" },
      url: resetUrl,
    });
  },
},

URL Building Helpers

Frontend Callback URL

const buildEmailUrlWithFrontendCallback = (
  originalUrl: string,
  frontendPath: string = "/dashboard"
): string => {
  const urlObj = new URL(originalUrl);
  urlObj.searchParams.set("callbackURL", `${frontendURL}${frontendPath}`);
  return urlObj.toString();
};

Password Reset URL

const buildPasswordResetFrontendUrl = (originalUrl: string): string => {
  const urlObj = new URL(originalUrl);
  const pathParts = urlObj.pathname.split("/").filter(Boolean);
  const token = pathParts[pathParts.length - 1];
  return `${frontendURL}/reset-password?token=${token}`;
};

Environment Variables

EMAIL_FROM_ADDRESS=noreply@example.com
EMAIL_FROM_NAME=FlowStack

References