mjml-react ·  

·

There is an awesome library mjml with github repo here https://github.com/mjmlio/mjml.

MJML is a markup language created by Mailjet.
So in order to create emails on the fly we created a library with React components.

How it works

Install the required dependencies first:

``bash
npm install react react-dom mjml mjml-react
`

And afterwards write a code like a pro:

`js
import {
render,
Mjml,
MjmlHead,
MjmlTitle,
MjmlPreview,
MjmlBody,
MjmlSection,
MjmlColumn,
MjmlButton,
MjmlImage
} from 'mjml-react';

const {html, errors} = render((


Last Minute Offer
Last Minute Offer...









padding="20px"
backgroundColor="#346DB7"
href="https://www.wix.com/"
>
I like it!





), {validationLevel: 'soft'});
`

And as the result you will get a nice looking email HTML (works in mobile too!)

!preview

Options

mjml-react sets the following MJML options when rendering to HTML:

`js
{
keepComments: false,
beautify: false,
minify: true,
validationLevel: 'strict'
}
`

If you want to override these, you can pass an object to render as a second argument. See the MJML docs for the full list of options you can set.

Extensions

`js
import {
MjmlHtml,
MjmlComment,
MjmlConditionalComment
} from 'mjml-react/extensions';

Built with ... at ...
//

MSO conditionals
//

MSO conditionals
//


//


`

Utils

We do have also some utils for post processing the output HTML.
Because not all mail clients do support named HTML entities, like '.
So we need to replace them to hex.

`js
import {
namedEntityToHexCode,
fixConditionalComment
} from 'mjml-react/utils';

const html = '

';
namedEntityToHexCode(html);
//

'

fixConditionalComment('', 'Hello', 'if IE');
//
`

Limitations

Currently mjml and mjml-react` libraries are meant to be run inside a node.

Example project

You can find an example project here
https://github.com/wix-incubator/mjml-react-example