Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
@faire/mjml-react
Advanced tools
Readme
Hello mjml community, we at Faire are excited to announce we will be taking over maintaining the open-source mjml-react project!
Over the past year, Faire has used mjml-react extensively. This package allowed us to incorporate all the benefits of mjml without having to ask our developers to learn a new dev environment when moving from web to email. As a result, we significantly reduced the development effort for creating emails, while keeping email rendering issues to a minimum.
We saw so much benefit from mjml-react, and we don’t want to see it go. That is why we want to continue to maintain the package, and improve it with some of our own new ideas! For now you can check us out at @faire/mjml-react. We hope this can be a drop-in replacement for mjml-react in most cases, but are eager to work with you if there are any issues. Don’t hesitate to reach out to us on the #mjml-react channel in the MJML Slack Group or file a github issue. From there, you can look forward to new improvements coming soon.
And of course we want to extend a massive thank you to the Wix team for building and previously maintaining this project.
·
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.
V2 is a drop in replacement for https://github.com/wix-incubator/mjml-react/, with some additional support. If there's a component missing you can make a PR against https://github.com/Faire/mjml-react/tree/main-v2 or submit an issue and we'll try to unblock you.
We wanted V3 of mjml-react to be fairly easy to migrate to from V2. We will implement more advanced features in V4. The main updates in V3 include:
In V4 we are exploring exciting features that will make mjml-react even more powerful. This includes:
If you want to be on the cutting edge of what is being released, we are publishing a v4-main-alpha version to npm.
node:
npm install @faire/mjml-react mjml react react-dom
browser:
npm install @faire/mjml-react mjml-browser react react-dom
mjml
or mjml-browser
)import { renderToMjml } from "@faire/mjml-react/utils/renderToMjml";
// import mjml2html from "mjml";
// import mjml2html from "mjml-browser";
import { MJMLParseResults } from "mjml-core";
import React from "react";
export function renderReactToMjml(email: React.ReactElement): MJMLParseResults {
return mjml2html(renderToMjml(email));
}
import {
Mjml,
MjmlHead,
MjmlTitle,
MjmlPreview,
MjmlBody,
MjmlSection,
MjmlColumn,
MjmlButton,
MjmlImage,
} from "@faire/mjml-react";
import { renderReactToMjml } from "./renderReactToMjml";
const { html, errors } = renderReactToMjml(
<Mjml>
<MjmlHead>
<MjmlTitle>Last Minute Offer</MjmlTitle>
<MjmlPreview>Last Minute Offer...</MjmlPreview>
</MjmlHead>
<MjmlBody width={500}>
<MjmlSection fullWidth backgroundColor="#efefef">
<MjmlColumn>
<MjmlImage src="https://static.wixstatic.com/media/5cb24728abef45dabebe7edc1d97ddd2.jpg" />
</MjmlColumn>
</MjmlSection>
<MjmlSection>
<MjmlColumn>
<MjmlButton
padding="20px"
backgroundColor="#346DB7"
href="https://www.wix.com/"
>
I like it!
</MjmlButton>
</MjmlColumn>
</MjmlSection>
</MjmlBody>
</Mjml>,
{ validationLevel: "soft" }
);
And as the result you will get a nice looking email HTML (works in mobile too!)
@faire/mjml-react sets the following MJML options when rendering to HTML:
{
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.
import {
MjmlHtml,
MjmlComment,
MjmlConditionalComment
} from '@faire/mjml-react/extensions';
<MjmlComment>Built with ... at ...</MjmlComment>
// <!--Built with ... at ...-->
<MjmlConditionalComment>MSO conditionals</MjmlConditionalComment>
// <!--[if gte mso 9]>MSO conditionals<![endif]-->
<MjmlConditionalComment condition="if IE">MSO conditionals</MjmlConditionalComment>
// <!--[if IE]>MSO conditionals<![endif]-->
<MjmlHtml tag="div" html="<span>Hello World!</span>" />
// <div><span>Hello World!</span></div>
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.
import {
namedEntityToHexCode,
fixConditionalComment,
} from "@faire/mjml-react/utils";
const html = "<div>'</div>";
namedEntityToHexCode(html);
// <div>'</div>
fixConditionalComment(
"<!--[if mso]><div>Hello World</div><![endif]-->",
"Hello",
"if IE"
);
// <!--[if IE]><div>Hello World</div><![endif]-->
Currently mjml
and @faire/mjml-react
libraries are meant to be run inside a node.
You can find an example project here https://github.com/wix-incubator/mjml-react-example
FAQs
React component library to generate the HTML emails on the fly
The npm package @faire/mjml-react receives a total of 27,294 weekly downloads. As such, @faire/mjml-react popularity was classified as popular.
We found that @faire/mjml-react demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 3 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.