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
npx skills add oakoss/agent-skills --skill react-email -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/react-email/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/react-email/
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill react-email -a codex2Manually: put the files in place
.agents/skills/react-email/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill react-email -a cursor2Manually: put the files in place
.cursor/skills/react-email/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/react-email2Manually: put the files in place
.github/skills/react-email/SKILL.md1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill react-email -a gemini-cli2Platform CLI
gemini skills install https://github.com/oakoss/agent-skills --path skills/react-emailManually: put the files in place
.devin/skills/react-email/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill react-email -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.