PHPackages                             bbs-lab/laravel-mail-mjml - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail & Notifications](/categories/mail)
4. /
5. bbs-lab/laravel-mail-mjml

ActiveLibrary[Mail & Notifications](/categories/mail)

bbs-lab/laravel-mail-mjml
=========================

Laravel package for building responsive emails with MJML and Mailables.

v1.0.0(3w ago)04[1 PRs](https://github.com/BBS-Lab/laravel-mail-mjml/pulls)MITPHPPHP ^8.3CI passing

Since May 18Pushed 1w agoCompare

[ Source](https://github.com/BBS-Lab/laravel-mail-mjml)[ Packagist](https://packagist.org/packages/bbs-lab/laravel-mail-mjml)[ Docs](https://github.com/BBS-Lab/laravel-mail-mjml)[ RSS](/packages/bbs-lab-laravel-mail-mjml/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (18)Versions (4)Used By (0)

Laravel Mail MJML
=================

[](#laravel-mail-mjml)

[![Latest Version on Packagist](https://camo.githubusercontent.com/996e5f52d440575085fb67cd8e310b8dc42736d813e876eb7d6a670882689d3e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6262732d6c61622f6c61726176656c2d6d61696c2d6d6a6d6c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bbs-lab/laravel-mail-mjml)[![GitHub Tests Action Status](https://camo.githubusercontent.com/07c61affc7b69f15dc4f09a83e8b084659b3aa44b19677bca06bdeb9e82c524a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f4242532d4c61622f6c61726176656c2d6d61696c2d6d6a6d6c2f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/BBS-Lab/laravel-mail-mjml/actions?query=workflow%3Arun-tests+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/377c3a70a62e5b48872765b86414c565bd920b0ef23b9e2ea14da337dd18e9e5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6262732d6c61622f6c61726176656c2d6d61696c2d6d6a6d6c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bbs-lab/laravel-mail-mjml)

Build responsive transactional e-mails with [MJML](https://mjml.io/) and Laravel `Mailable` classes — with **Blade inside your templates and `` partials**.

Maintained fork of [`asahasrabuddhe/laravel-mjml`](https://github.com/asahasrabuddhe/laravel-mjml). No application-level `RerenderMjml` workaround required.

Contents
--------

[](#contents)

- [Features](#features)
- [Requirements](#requirements)
- [Installation](#installation)
- [Quick start](#quick-start)
- [Recommended layout](#recommended-layout)
- [Usage](#usage)
- [How it works](#how-it-works)
- [Configuration](#configuration)
- [Compiler API](#compiler-api)
- [Migrating from the original package](#migrating-from-the-original-package)
- [Quality & testing](#quality--testing)
- [Changelog](#changelog)

Features
--------

[](#features)

- **`BuildsMjmlMail` trait** — add MJML to any `Illuminate\Mail\Mailable`
- **Blade in root views and includes** — `{{ }}`, `@if`, `trans()`, `asset()`, `config()`, nested ``
- **HTML + plain text** — text part generated from compiled HTML
- **Compile cache** — artifacts stored under Laravel’s `view.compiled` path
- **Strict quality bar** — Pest, PHPStan level 8, 100% line coverage on `src/`

Requirements
------------

[](#requirements)

ToolVersionPHP`^8.3` (see CI matrix per Laravel version)Laravel`^11`, `^12`, or `^13`Node.js20+ (CI E2E uses Node 24)MJML CLIvia `npm install mjml` (or custom binary in config)Installation
------------

[](#installation)

```
composer require bbs-lab/laravel-mail-mjml
npm install --save-dev mjml
```

Publish configuration (optional):

```
php artisan vendor:publish --tag="laravel-mail-mjml-config"
```

The package auto-registers `LaravelMjmlServiceProvider`. No manual setup beyond the trait on your mailables.

Quick start
-----------

[](#quick-start)

**1. Trait on your mailable**

```