Laravel MailBridge

Provider-neutral transactional and marketing email for Laravel 12+.

MailBridge keeps your application code stable while providers, SDKs, template ids, and marketing APIs vary behind adapters. Use normal Laravel mail when you want it. Use MailBridge when you need provider-hosted templates, marketing lists, capability checks, tested SDK pins, and provider fallback.

Documentation

Full docs: https://ashraful19.github.io/laravel-mailbridge/

Source docs:

• Installation
• Provider install
• Normal Laravel mail
• Transactional email
• Hosted templates
• Marketing email
• Fallback
• Testing
• Security
• Capabilities

Quick Start

composer require ashraful19/laravel-mailbridge
php artisan vendor:publish --tag=mailbridge-config
php artisan mailbridge:install

mailbridge:install opens a terminal checklist so you can install one or more provider SDKs. The base package does not install every SDK.

Basic Usage

Existing Laravel mail stays unchanged:

Mail::to($user)->send(new WelcomeMail($user));

Send a Laravel Mailable through MailBridge:

MailBridge::transactional()
    ->to($user->email, $user->name)
    ->send(new WelcomeMail($user));

Send a provider-hosted template:

MailBridge::transactional()
    ->template('welcome')
    ->to($user->email)
    ->data(['name' => $user->name])
    ->send();

Send through one provider for this request:

MailBridge::transactional('postmark')
    ->withFallback(false)
    ->to($user->email)
    ->subject('Welcome')
    ->text('Hello')
    ->send();

Subscribe a marketing contact:

use Ashraful19\LaravelMailbridge\Data\Subscriber;

MailBridge::marketing()
    ->list('signup')
    ->subscribe(Subscriber::make($user->email)->name($user->name));

Providers

Provider SDKs are installed only when selected, and each install command uses the exact SDK version tested by MailBridge.

Run health checks anytime:

php artisan mailbridge:doctor

Features

Transactional email:

Marketing email:

Why MailBridge

License

Laravel MailBridge is open-sourced software licensed under the MIT license.