The Open Standard for Generative UI
React Email
AI-powered email generator built with OpenUI and React Email.
Describe an email in natural language, and the AI generates a live preview with exportable HTML. Iterate on the design through follow-up prompts.
Features
- 44 email components — headers, footers, feature grids, pricing cards, checkout tables, testimonials, and more
- Live preview — see the email render in real time as the AI streams its response
- Copy HTML — one-click export of email-client-compatible HTML (pretty-formatted via
@react-email/render) - Copy subject — grab the generated subject line
- Conversation starters — pre-built prompts for common email types (OpenUI launch, abandoned cart, conference invite, travel newsletter)
- Iterative design — refine the email through follow-up messages
- Dark mode — automatic system theme detection
Prerequisites
- Node.js 20+
- pnpm, npm, or Bun
- An OpenUI Cloud API key
Getting Started
- Clone the repo, enter this standalone example, and install its dependencies:
git clone https://github.com/thesysdev/openui.git
cd openui/examples/miscellaneous/react-email
pnpm install --ignore-workspace
- Copy
.env.exampleto.env.localand add your OpenUI Cloud API key:
cp .env.example .env.local
Edit .env.local:
THESYS_API_KEY=sk-th-...
- Start the development server:
pnpm dev
The app will be available at http://localhost:3000.
Scripts
| Command | Description |
|---|---|
pnpm dev |
Start dev server (auto-generates library spec) |
pnpm build |
Production build |
pnpm start |
Start production server |
pnpm lint |
Run ESLint |
Key Dependencies
| Package | Purpose |
|---|---|
@openuidev/react-email |
44 email components + system prompt generation |
@openuidev/react-lang |
Renderer — parses OpenUI Lang and renders components |
@openuidev/react-headless |
Chat thread state management |
@react-email/components |
Email-compatible HTML primitives |
@react-email/render |
Converts React components to email HTML |
next |
App framework (Next.js 16) |
openai |
OpenAI streaming API client |
Project Structure
src/
app/
page.tsx # Main app — compose + editor views
layout.tsx # Root layout with theme provider
api/chat/route.ts # Cloud Completions streaming API route
components/
composePage/
index.tsx # Landing page with conversation starters
starters.ts # Conversation starter prompts
emailEditor/
index.tsx # Split view orchestrator
topBar.tsx # Header with title + generating indicator
htmlPanel.tsx # Left panel — HTML code output
previewPanel.tsx # Right panel — live email preview
messageInput.tsx # Bottom input form
mobileTabToggle.tsx # Mobile HTML/Preview tab switcher
loadingDots.tsx # Loading animation (shared)
session.ts # Session persistence (shared)
hooks/
useSystemTheme.tsx # Dark/light theme detection
useIsMobile.ts # Responsive breakpoint hook
useClipboard.ts # Copy-to-clipboard hook
useAutoScroll.ts # Auto-scroll with user override
useEmailRendering.tsx # HTML rendering + streaming lifecycle
lib/
cloud-prompt.ts # Wraps the generated spec in Cloud's prompt
generated/
spec.json # Auto-generated from @openuidev/react-email
prompt-options.json # Examples + rules for the Cloud prompt
How It Works
- The library spec is generated at build time from
@openuidev/react-email; the chat route wraps it in OpenUI Cloud's managed prompt - User describes an email (or clicks a starter)
- The AI responds in OpenUI Lang format
- The
Rendererfrom@openuidev/react-langparses and renders the email components in real time usingemailLibrary - Once streaming completes,
useEmailRenderingcallsrender()from@react-email/renderwith{ pretty: true }client-side to produce copyable, formatted HTML
What the package provides
The @openuidev/react-email package exports:
emailLibrary— ready-to-use library with 44 components (pass to<Renderer>)emailPromptOptions— examples + rules for the LLM system promptemailComponentGroups— organized component groups with usage notesemailExamples— 10 example email templatesemailAdditionalRules— 40 email design rules
Individual components are internal to the library — consumers only need emailLibrary.
Verify
pnpm verify