Swiftpack.co - Package - LiveUI/MailCore

LiveUI MailCore

Slack Jenkins Platforms Swift Package Manager Swift 4 Vapor 3

Mailing wrapper for multiple mailing services like Mailgun, SendGrid or SMTP


  • ☑ Mailgun
  • ☑ SendGrid
  • ☑ SMTP
  • ☐ Attachments
  • ☐ Multiple emails sent at the same time
  • ☑ Multiple recipint, CC & BCC fields


Just add following line package to your Package.swift file.

.package(url: "https://github.com/LiveUI/MailCore.git", .branch("master"))


Usage is really simple mkey!

1/3) Configure

First create your client configuration:


let config = Mailer.Config.mailgun(key: "{mailgunApi}", domain: "{mailgunDomain}", region: "{mailgunRegion}")


let config = Mailer.Config.sendGrid(key: "{sendGridApiKey}")


Use the SMTP struct as a handle to your SMTP server:

let smtp = SMTP(hostname: "smtp.gmail.com",     // SMTP server address
                   email: "user@gmail.com",     // username to login
                password: "password")           // password to login
let config = Mailer.Config.smtp(smtp)

SMTP using TLS

All parameters of SMTP struct:

let smtp = SMTP(hostname: String,
                   email: String,
                password: String,
                    port: Int32 = 465,
                  useTLS: Bool = true,
        tlsConfiguration: TLSConfiguration? = nil,
             authMethods: [AuthMethod] = [],
             accessToken: String? = nil,
              domainName: String = "localhost",
                 timeout: UInt = 10)
let config = Mailer.Config.smtp(smtp)

2/3) Register service

Register and configure the service in your apps configure method.

Mailer(config: config, registerOn: &services)

Mailer.Config is an enum and you can choose from any integrated services to be used

3/3) Send an email

let mail = Mailer.Message(from: "admin@liveui.io", to: "bobby.ewing@southfork.com", subject: "Oil spill", text: "Oooops I did it again", html: "<p>Oooops I did it again</p>")
return try req.mail.send(mail).flatMap(to: Response.self) { mailResult in
    // ... Return your response for example


Mailcore provides a MailCoreTestTools framework which you can import into your tests to get MailerMock.

To register, and potentially override any existing "real" Mailer service, just initialize MailerMock with your services.

// Register
MailerMock(services: &services)

// Retrieve in your tests
let mailer = try! req.make(MailerService.self) as! MailerMock

MailerMock will store the last used result as well as the received message and request. Structure of the moct can be seen below:

public class MailerMock: MailerService {

    public var result: Mailer.Result = .success
    public var receivedMessage: Mailer.Message?
    public var receivedRequest: Request?

    // MARK: Initialization

    @discardableResult public init(services: inout Services) {
        services.remove(type: Mailer.self)
        services.register(self, as: MailerService.self)

    // MARK: Public interface

    public func send(_ message: Mailer.Message, on req: Request) throws -> Future<Mailer.Result> {
        receivedMessage = message
        receivedRequest = req
        return req.eventLoop.newSucceededFuture(result: result)

    public func clear() {
        result = .success
        receivedMessage = nil
        receivedRequest = nil



Join our Slack, channel #help-boost to ... well, get help :)

Enterprise AppStore

Core package for Einstore, a completely open source enterprise AppStore written in Swift!

  • Website: http://www.einstore.io
  • Github: https://github.com/Einstore/Einstore

Other core packages

  • EinstoreCore - AppStore core module
  • ApiCore - Base user & team management including forgotten passwords, etc ...

Implemented thirdparty providers

  • Mailgun - https://github.com/twof/VaporMailgunService
  • SendGrig - https://github.com/vapor-community/sendgrid-provider
  • SMTP - https://github.com/IBM-Swift/Swift-SMTP

Code contributions

We love PR’s, we can’t get enough of them ... so if you have an interesting improvement, bug-fix or a new feature please don’t hesitate to get in touch. If you are not sure about something before you start the development you can always contact our dev and product team through our Slack.


Ondrej Rafaj (@rafiki270 on Github, Twitter, LiveUI Slack and Vapor Slack)


MIT license, please see LICENSE file for more details.


Stars: 76

Used By

Total: 0


3.1.0 - 2020-05-08 08:21:32

Bulk SMTP email sending

Thanks @LinusGeffarth :)

0.3.0 - 2019-09-04 17:05:45

  • Mailgun now requires region to be set

Thanks @tomwildcat9

0.2.4 - 2019-06-18 20:53:18

Fixing logger dependency issue

0.2.3 - 2019-05-30 08:42:50

  • CC
  • BCC

SendGrid fix - 2018-09-07 10:18:29

  • Fixes how the recipient is sent when using SendGrid (#6)

Upgrading dependencies - 2018-05-08 09:59:55


  • SMTP User update
  • SMTP Crypto remove warnings

Adding SMTP - 2018-04-11 08:13:13

  • Using Kitura SMTP
  • Better README
  • Described testing tools

First release - 2018-04-11 06:25:09