Mailables render views and go out through any transport.

A mailable is an envelope and content. The content is an ordinary template, so a mail is previewable and testable like a page.

Read the Mail docs

Worker log of three emails sent through the log transport, each with recipient, subject and body.

What you get

Transports: SMTP, Amazon SES, Postmark, Mailgun, SendGrid and Resend.
Log, file and memory transports for development and tests.
Mailer::fake() with assert_sent_to and sent().

In the docs

Mail

src/app/mail/welcome.rs

use rainier_framework::prelude::*;

pub struct WelcomeEmail {
    pub name: String,
    pub email: String,
}

impl Mailable for WelcomeEmail {
    fn envelope(&self) -> Envelope {
        Envelope::new("Welcome!").to(self.email.clone())
    }

    fn content(&self) -> Result<Content> {
        // resources/views/mail/welcome.view.html
        Content::view("mail.welcome", json!({ "name": self.name }))
    }
}

// Through the configured transport: SMTP, SES, Postmark, Mailgun, SendGrid, Resend…
Mail::instance().send(&WelcomeEmail { name, email }).await?;

Up close

Select an image to see it full size.

Rust source of the PostLiveMail Mailable: envelope, content view and headers. — A Mailable is a struct with an envelope, a view and headers, rendered by the same template engine as pages.

Lookout timeline rows ending with view mail.post_live and mail via log to 1 recipient. — The mail view render and the send appear on the timeline of the request that queued them.

All features