# react-email

> A live preview of your emails right in your browser.

Latest version **6.11.16** (published 2026-11-17) · MIT license · 0 weekly downloads

## Install

```sh
npm install react-email
pnpm add react-email
yarn add react-email
bun add react-email
```

Provides the command `email`.

## Health

**Score 80/100 (A)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score; popular repo.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 6.11.16 |
| Published | 2026-11-17 |
| First published | 2016-05-19 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Node | >=20.19.0 |
| Dependencies | 19 |
| Unpacked size | 2.2 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 19881 |
| Maintainers | dielduarte, zenorocha, bukinoshita, felipefreitag, gabrielmfern |
| Keywords | react, email |

## Links

- npm: https://www.npmjs.com/package/react-email
- Repository: https://github.com/resend/react-email
- Homepage: https://github.com/resend/react-email#readme
- Issues: https://github.com/resend/react-email/issues
- npm.io page: https://npm.io/package/react-email

## Dependencies (19)

- [conf](https://npm.io/package/conf.md) ^15.0.2
- [jiti](https://npm.io/package/jiti.md) 2.6.1
- [nypm](https://npm.io/package/nypm.md) 0.6.6
- [marked](https://npm.io/package/marked.md) ^15.0.12
- [esbuild](https://npm.io/package/esbuild.md) ^0.28.0
- [prismjs](https://npm.io/package/prismjs.md) ^1.30.0
- [prompts](https://npm.io/package/prompts.md) 2.4.2
- [chokidar](https://npm.io/package/chokidar.md) ^5.0.0
- [css-tree](https://npm.io/package/css-tree.md) 3.2.1
- [commander](https://npm.io/package/commander.md) ^13.0.0
- [socket.io](https://npm.io/package/socket.io.md) ^4.8.1
- [mime-types](https://npm.io/package/mime-types.md) ^3.0.0
- [log-symbols](https://npm.io/package/log-symbols.md) ^7.0.0
- [picospinner](https://npm.io/package/picospinner.md) ^3.0.0
- [tailwindcss](https://npm.io/package/tailwindcss.md) ^4.1.18
- [@babel/parser](https://npm.io/package/@babel/parser.md) 7.29.2
- [tsconfig-paths](https://npm.io/package/tsconfig-paths.md) 4.2.0
- [@babel/traverse](https://npm.io/package/@babel/traverse.md) 7.29.0
- [@react-email/render](https://npm.io/package/@react-email/render.md) >=2.3.1

## Alternatives

- [@expo/fingerprint](https://npm.io/package/@expo/fingerprint.md) — 6.2M weekly downloads
- [@azure/monitor-opentelemetry-exporter](https://npm.io/package/@azure/monitor-opentelemetry-exporter.md) — 850.0K weekly downloads
- [@azure/monitor-opentelemetry](https://npm.io/package/@azure/monitor-opentelemetry.md) — 624.0K weekly downloads
- [@posthog/ai](https://npm.io/package/@posthog/ai.md) — 423.3K weekly downloads
- [fakefilter](https://npm.io/package/fakefilter.md) — 63.9K weekly downloads

## Recent versions

- 6.11.16 (latest) — 2026-11-17
- 5.2.11 (previous) — 2026-04-17
- 6.0.0-canary.2 (canary) — 2026-04-16
- 4.0.1-alpha.202403272003 (alpha) — 2025-03-27
- 6.11.15 — 2026-11-17
- 6.11.14 — 2026-11-16
- 6.11.13 — 2026-11-13
- 6.11.12 — 2026-11-12
- 6.11.11 — 2026-11-10
- 6.11.10 — 2026-11-09
- 6.11.9 — 2026-11-09
- 6.11.8 — 2026-11-06
- 6.11.7 — 2026-11-05
- 6.11.6 — 2026-10-29
- 6.11.5 — 2026-10-28
- … 294 more at https://npm.io/package/react-email/versions

## README

![React email cover](https://react.email/static/covers/react-email.png)

<div align="center"><strong>React Email</strong></div>
<div align="center">The next generation of writing emails.<br />High-quality, unstyled components for creating emails.</div>
<br />
<div align="center">
<a href="https://react.email">Website</a>
<span> · </span>
<a href="https://github.com/resend/react-email">GitHub</a>
</div>

## Introduction

A collection of high-quality, unstyled components for creating beautiful emails using React and TypeScript.
It reduces the pain of coding responsive emails with dark mode support. It also takes care of inconsistencies between Gmail, Outlook, and other email clients for you.

## Why

We believe that email is an extremely important medium for people to communicate. However, we need to stop developing emails like 2010, and rethink how email can be done in 2026 and beyond. Email development needs a revamp. A renovation. Modernized for the way we build web apps today.

## Install

```sh
npm i react-email@latest
```

## Getting started

Define your email template with React, include styles and our components where needed.

```jsx
import { Button } from "react-email";

export default function Email() {
  return (
    <Button href="https://example.com" style={{ color: "#61dafb" }}>
      Click me
    </Button>
  );
};
```

## Using with AI

Install the React Email skill to teach your coding agent (Claude Code, Codex, Cursor, GitHub Copilot, and others) how to build emails with React Email:

```sh
npx skills add resend/react-email
```

The docs are also available for LLMs at [react.email/docs/llms.txt](https://react.email/docs/llms.txt).

## Components

A set of standard components to help you build amazing emails without having to deal with the mess of creating table-based layouts and maintaining archaic markup.

- [Html](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/html)
- [Head](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/head)
- [Button](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/button)
- [Container](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/container)
- [CodeBlock](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/code-block)
- [CodeInline](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/code-inline)
- [Column](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/column)
- [Row](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/row)
- [Font](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/font)
- [Heading](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/heading)
- [Divider](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/hr)
- [Image](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/img)
- [Link](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/link)
- [Markdown](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/markdown)
- [Preview](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/preview)
- [Section](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/section)
- [Tailwind](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/tailwind)
- [Paragraph](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/text)
- [Body](https://github.com/resend/react-email/tree/main/packages/react-email/src/components/body)

## Editor

React Email also provides an Editor built on top of [TipTap](https://tiptap.dev/) and [ProseMirror](https://prosemirror.net/), It serializes to React Email components, and exports email-ready HTML and plain text.

See the [Editor documentation](https://react.email/docs/editor) for more details.

## Integrations

Emails built with React Email can be converted into HTML and sent using any email service provider. Here are some examples:

- [Resend](https://github.com/resend/react-email/tree/main/examples/resend)
- [Nodemailer](https://github.com/resend/react-email/tree/main/examples/nodemailer)
- [SendGrid](https://github.com/resend/react-email/tree/main/examples/sendgrid)
- [MailerSend](https://github.com/resend/react-email/tree/main/examples/mailersend)
- [Mailgun](https://github.com/resend/react-email/tree/main/examples/mailgun)
- [Postmark](https://github.com/resend/react-email/tree/main/examples/postmark)
- [AWS SES](https://github.com/resend/react-email/tree/main/examples/aws-ses)
- [Azure Communication Email](https://github.com/resend/react-email/tree/main/examples/azure-communication-email)
- [Plunk](https://github.com/resend/react-email/tree/main/examples/plunk)
- [Scaleway](https://github.com/resend/react-email/tree/main/examples/scaleway)

## Support

All components were tested using the most popular email clients.

| <img src="https://react.email/static/icons/gmail.svg" width="48px" height="48px" alt="Gmail logo"> | <img src="https://react.email/static/icons/apple-mail.svg" width="48px" height="48px" alt="Apple Mail"> | <img src="https://react.email/static/icons/outlook.svg" width="48px" height="48px" alt="Outlook logo"> | <img src="https://react.email/static/icons/yahoo-mail.svg" width="48px" height="48px" alt="Yahoo! Mail logo"> | <img src="https://react.email/static/icons/hey.svg" width="48px" height="48px" alt="HEY logo"> | <img src="https://react.email/static/icons/superhuman.svg" width="48px" height="48px" alt="Superhuman logo"> |
| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| Gmail ✔                                                                                           | Apple Mail ✔                                                                                           | Outlook ✔                                                                                             | Yahoo! Mail ✔                                                                                                | HEY ✔                                                                                         | Superhuman ✔                                                                                                |

## Development workflow

1. [Setting up your development environment](https://react.email/docs/contributing/development-workflow/1-setup)
2. [Running tests](https://react.email/docs/contributing/development-workflow/2-running-tests)
3. [Linting](https://react.email/docs/contributing/development-workflow/3-linting)
4. [Building](https://react.email/docs/contributing/development-workflow/4-building)
5. [Writing documentation](https://react.email/docs/contributing/development-workflow/5-writing-docs)

## Contributing

- [Contribution Guide](https://react.email/docs/contributing)

---

Brought to you by [Resend](https://resend.com), MIT License.

---
_Source: https://npm.io/package/react-email · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
