Skip to main content
skill CX Codex

react-email · oakoss — Claude Code skill for React emails

Build responsive HTML emails from React Email components and render them as HTML or plain text. Useful for transactional messages and marketing templates.

MIT 122 installs ★ 29 updated 2026-08-17

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add oakoss/agent-skills --skill react-email -a claude-code
Open on GitHub

What react-email does

The skill guides you through assembling an email with React Email components: its document structure, text, buttons, images, and inbox preview. For layouts, it uses Section, Row, and Column to produce table-based markup for email clients instead of CSS Grid or Flexbox.

Choose inline CSS objects or wrap the email in Tailwind, which inlines classes during rendering. The render() function is asynchronous, so await its result. For local preview, run email dev; the server reloads as you work.

On Claude Code, installation adds the skill at ~/.claude/skills/react-email/SKILL.md. If you use a custom font, place Font inside Head or it will not load.

What it helps with

  • build a responsive email from React components
  • set inbox preview text for an email
  • lay out email content with tables for email clients
  • render an email as HTML or plain text

Example prompts for the agent

  • Create a password-reset email with React Email, including a button and inbox preview.
  • Review this email layout and replace CSS Grid with table-based components.
  • Render this email component as HTML and plain text.

How to install react-email

1Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill react-email -a claude-code

2Manually: put the files in place

~/.claude/skills/react-email/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/react-email/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about react-email

How do I install react-email in Claude Code?

Run npx skills add oakoss/agent-skills --skill react-email -a claude-code. The skill file is added at ~/.claude/skills/react-email/SKILL.md.

What does react-email do?

It helps build emails from React components and render them as HTML or plain text. The skill covers document structure, styling, layout, and inbox previews.

How should I style an email with Tailwind?

Wrap Html with Tailwind so classes are inlined during rendering. Avoid combining className and style on the same element.

Source text

SKILL.md · MIT
---
name: react-email
description: >
  Build responsive HTML emails with React Email components. Covers email structure (Html, Head, Body, Container),
  content components (Text, Heading, Button, Link, Img), layout (Section, Row, Column), styling with inline CSS
  and Tailwind, custom fonts, preview text, and rendering to HTML.

  Use when creating transactional emails, marketing templates, or email design systems.
  Use for email rendering, preview, Tailwind email styling, and provider integration with Resend, Nodemailer, or SendGrid.
license: MIT
metadata:
  author: oakoss
  version: '1.1'
  source: https://react.email/docs
user-invocable: false
---

# React Email

## Overview

React Email is a library for building responsive HTML emails using React components. It provides a set of unstyled, accessible components that render to email-client-compatible HTML. Supports inline styles, Tailwind CSS via a wrapper component, custom web fonts, and rendering to both HTML and plain text.

**When to use:** Transactional emails (welcome, password reset, receipts), marketing templates, email design systems, any project that renders emails server-side.

**When NOT to use:** Static HTML email templates with no dynamic content, projects that already use a dedicated email builder (MJML, Maizzle), or when you only need plain-text emails.

## Quick Reference

| Pattern            | API                                      | Key Points                                                  |
| ------------------ | ---------------------------------------- | ----------------------------------------------------------- |
| Document structure | `Html`, `Head`, `Body`                   | `Html` wraps everything, `Head` loads fonts/meta            |
| Content container  | `Container`                              | Centers content, sets `max-width`                           |
| Layout grid        | `Section`, `Row`, `Column`               | Table-based layout for email clients                        |
| Text content       | `Text`, `Heading`                        | `Heading` accepts `as` prop for h1-h6                       |
| Links              | `Link`                                   | Standard anchor, `href` required                            |
| Call-to-action     | `Button`                                 | Renders as link styled as button, `href` required           |
| Images             | `Img`                                    | Always set `width`, `height`, `alt`                         |
| Divider            | `Hr`                                     | Horizontal rule between sections                            |
| Inbox preview      | `Preview`                                | Sets preview text shown in inbox list                       |
| Custom fonts       | `Font`                                   | Place inside `Head`, set `webFont` and `fallbackFontFamily` |
| Tailwind styling   | `Tailwind`                               | Wraps email, inlines Tailwind classes at render             |
| Render to HTML     | `render(<Email />)`                      | Async, returns HTML string                                  |
| Render plain text  | `render(<Email />, { plainText: true })` | Strips HTML, returns text                                   |
| Pretty output      | `render(<Email />, { pretty: true })`    | Formatted HTML for debugging                                |
| Preview server     | `email dev`                              | Local dev server with hot reload                            |
| Markdown content   | `Markdown`                               | Renders Markdown as email-compatible HTML                   |
| Code blocks        | `CodeBlock`                              | Syntax-highlighted code with theme support                  |
| Inline code        | `CodeInline`                             | Monospace inline code spans                                 |

## Common Mistakes

| Mistake                                         | Correct Pattern                                                                           |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------- |
| Using `className` with inline styles            | Use either Tailwind (`className`) or inline `style` objects, not both on the same element |
| Forgetting `width`/`height` on `Img`            | Always specify dimensions to prevent layout shifts in email clients                       |
| Nesting `Container` inside `Container`          | Use one `Container` for centering, `Section`/`Row`/`Column` for inner layout              |
| Using CSS Grid or Flexbox                       | Use `Section`, `Row`, `Column` for table-based layouts that work across email clients     |
| Placing `Font` outside `Head`                   | `Font` must be a child of `Head` to load correctly                                        |
| Using `render()` synchronously                  | `render()` is async, always `await` the result                                            |
| Wrapping `Tailwind` inside `Html`               | `Tailwind` wraps `Html`, not the other way around                                         |
| Omitting `Preview` component                    | Without `Preview`, email clients show the first body text as preview                      |
| Using external CSS stylesheets                  | Email clients strip `<link>` tags; use inline styles or Tailwind component                |
| Passing React component to `resend.emails.send` | Render to HTML string first, then pass `html` to the send method                          |

## Delegation

- **Email template discovery**: Use `Explore` agent
- **Email styling review**: Use `Task` agent
- **Code review**: Delegate to `code-reviewer` agent

> If the `resend` skill is available, delegate email delivery tasks to it.
> Otherwise, recommend: `npx skills add oakoss/agent-skills --skill resend`

## References

- [Built-in components: structure, content, and layout](references/components.md)
- [Styling with inline CSS, Tailwind, responsive patterns, and fonts](references/styling-and-layout.md)
- [Rendering to HTML, preview server, and provider integration](references/rendering.md)

© oakoss · MIT · oakoss/agent-skills

Similar skills

All skills for Frontend and UI →

react-email by other authors comes first.

react-email vercel-labs Converts a JSON element tree into an HTML or plain-text email via @json-render/react-email. Kicks in when building transactional or marketing emails from AI-generated specs. CX Codex +1 1,400installs react-email Resend react-email is a Claude Code skill for building HTML emails with React components and adding a visual editor to an app. It also covers rendering and sending email through Resend. CX Codex +1 13,500installs email-html-mjml Framix email-html-mjml is a Claude Code skill that builds responsive email templates with MJML and compiles them to HTML. It activates for new templates, .mjml edits, and email rendering issues. CX Codex +1 1,000installs email-render-builder aaron-he-zhu email-render-builder — a skill that turns an approved email creative into a responsive HTML build and runs render QA across Gmail, Outlook, Apple Mail, and mobile. It does not write the copy; that belongs to email-creative-builder. CX Codex +1 1,200installs stitch::react-components official google-labs-code stitch::react-components is a Claude Code skill that turns Stitch designs into modular Vite and React components and syncs existing components with updated designs. CX Codex +1 50,400installs mjml-email-templates Aaronontheweb mjml-email-templates is a Claude Code skill for building responsive MJML emails and setting up template rendering in .NET. It activates for transactional messages such as signup, password reset, invoices, and notifications. CX Codex +1 523installs react-bits Philotheephilix react-bits is a skill for Claude Code that adds animated UI components, text effects, and WebGL/canvas backgrounds to React projects. It activates when fetching current React Bits component code from the public registry. CX Codex +1 617installs generic-react-design-system travisjneuman generic-react-design-system is a Claude Code skill that provides reference patterns for React and TypeScript interfaces with Tailwind CSS, Framer Motion, and WCAG AA. CX Codex +1 191installs

From the same set106

The whole set →
performance-optimizer performance-optimizer provides structured workflows for profiling, caching, and full-stack performance tuning. Helps eliminate slow database queries, optimize bundles, and reduce API latency. CX Codex +1 124installs storybook-stories Writes Storybook stories and interaction tests in CSF3 format. Handles component examples, Chromatic visual snapshot setup, and accessibility checks. CX Codex +1 124installs shell-integration The shell-integration Claude Code skill provides terminal integration guides and Bash, Zsh, and Fish patterns for completions, prompt hooks, and portable POSIX wrappers. CX Codex +1 123installs usability-tester usability-tester plans usability test sessions, evaluates interfaces against heuristic standards, and scores UX friction points using severity formulas. CX Codex +1 122installs rag-implementer rag-implementer guides an agent through a retrieval-augmented generation build, from chunking and embeddings to hybrid retrieval and quality metrics. CX Codex +1 121installs service-worker service-worker guides the coding assistant in configuring Workbox v7.4 caching, offline app shells, background sync, and push notifications. CX Codex +1 121installs cli-power-tools cli-power-tools guides coding agents to use fast Rust-based command-line utilities and structured parsers instead of legacy shell pipelines. CX Codex +1 121installs quality-auditor quality-auditor runs a weighted audit across 12 dimensions, scores each one against cited evidence and hands back a prioritized fix list. CX Codex +1 120installs

Project sponsors

Companies that keep this analytics open