Warning

Ce dépôt a été migré sur GitLab le 25/09/2026 et n'est plus maintenu ici.

• Nouveau dépôt : https://gitlab.humanoid.fr/humanoid/webpack-mjml-plugin
• Contributions et merge requests se font désormais depuis GitLab.
• Ce dépôt GitHub est archivé en lecture seule. Suivi de la migration : PRO-6330.

Webpack MJML Plugin for compiling MJML files.

---

Installation 🎁

npm install webpack-mjml-plugin

Usage 🕹️

In your webpack.config.js simply:

const MJMLPlugin = require('webpack-mjml-plugin');

module.exports = {
  // ...
  plugins: [
    new MJMLPlugin('src/to/mjml', {
      extension: '.html',
      outputPath: path.resolve(__dirname, 'dist/to/mjml')
    });
  ]
};

API 🐝

The plugin supports all options that can be found in this documentation.

// webpack.config.js

module.exports = {
  plugins: [
    new MJMLPlugin(inputPath, {
      extension: options.extension,
      outputPath: options.outputPath,
      // MJML options (https://documentation.mjml.io/#inside-node-js)
      filePath: path.resolve(__dirname, 'src/to/mjml'),
      keepComments: false
    })
  ]
};

In addition to the options available in the MJML documentation, there are 3 additional parameters described in the table below:

Parameter	Type	Default	Description
inputPath	string	undefined	The path where .mjml files are located.
options.extensions	string	.html	The default output extension.
options.outputPath	string	process.cwd()	The path where compiled files should be written to.

Contributing 👥

Please read CONTRIBUTING.md for details on code of conduct, and the process for submitting pull requests.

License ⚖️

Webpack MJML Plugin is licensed under the MIT License - see the LICENSE.md file for details.