Movefast

Email Setup

Configure email providers for Magic Link and transactional emails

MoveFast supports three email providers: Resend, Postmark, and Nodemailer. Choose the one that fits your needs.

Common Configuration

Regardless of which provider you choose, add these to your .env.local:

env
EMAIL_FROM_EMAIL="noreply@yourdomain.com"
EMAIL_FROM_NAME="Your App Name"
VariableDescription
EMAIL_FROM_EMAILThe email address that appears in the "From" field
EMAIL_FROM_NAMEThe name that appears alongside the email address

Resend

Resend is a modern email API built for developers. Great for startups with a generous free tier.

1. Create an Account

  1. Sign up at resend.com
  2. Verify your domain or use their test domain for development
  3. Go to API Keys and create a new key

2. Add Environment Variables

env
RESEND_API_KEY="re_xxxxxxxxxx"
VariableDescription
RESEND_API_KEYYour Resend API key from the dashboard

Postmark

Postmark is known for excellent deliverability and fast delivery times. Great for transactional emails.

1. Create an Account

  1. Sign up at postmarkapp.com
  2. Create a new server
  3. Verify your sender signature (domain or email)
  4. Go to API Tokens and copy your Server API Token

2. Add Environment Variables

env
POSTMARK_API_KEY="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
VariableDescription
POSTMARK_API_KEYYour Postmark Server API Token

Nodemailer (SMTP)

Nodemailer lets you use any SMTP server. Great for self-hosted solutions or using Gmail, SendGrid, or other SMTP providers.

1. Get SMTP Credentials

Get your SMTP credentials from your email provider.

Gmail:

  • Host: smtp.gmail.com
  • Use an App Password (not your regular password)

2. Add Environment Variables

env
SMTP_HOST="smtp.gmail.com"
SMTP_USERNAME="your-email@gmail.com"
SMTP_PASSWORD="your-app-password"
VariableDescription
SMTP_HOSTSMTP server hostname
SMTP_USERNAMEYour SMTP username or email
SMTP_PASSWORDYour SMTP password or app-specific password

Testing Your Setup

After configuring your email provider, test it by:

  1. Start your development server: npm run dev
  2. Go to the sign-in page
  3. Enter your email and request a Magic Link
  4. Check your inbox (and spam folder)

If you don't receive the email, double-check your API keys and sender domain verification.