How to export all localized versions of all available emails?

[warm-tune]

I found out that export cli command doesn't support locale specification. Unfortunately I got that too late, when all emails and their translations already implemented. Rendered emails will be used in non-js environment, so I cannot render them in runtime.

How I can render all the emails on each available localization?

[apoorva-01]

Yeah, the export CLI doesn't take a locale flag, so it'll only ever spit out one language. But you don't need the CLI for this. render from react-email is just a function you can call yourself, so a small build script that loops locales × emails does exactly what you want and drops static HTML you can ship to a non-JS runtime.

Rough shape:

import { render } from "react-email";
import fs from "node:fs/promises";
import path from "node:path";

import Welcome from "./emails/welcome";
import Receipt from "./emails/receipt";

const locales = ["en", "de", "fr"];
const emails = { welcome: Welcome, receipt: Receipt };

for (const locale of locales) {
  for (const [name, Email] of Object.entries(emails)) {
    const html = await render(<Email locale={locale} />);
    const dir = path.join("out", locale);
    await fs.mkdir(dir, { recursive: true });
    await fs.writeFile(path.join(dir, `${name}.html`), html);
  }
}

Note render is async in v5, so await it (that trips people up after upgrading).

The one thing to get right is how the locale reaches your components. If your emails take a locale prop, the above is it. If they pull from an i18n provider/context instead, wrap the element in that provider with the locale set before you render, same as your app does at runtime. Either way you end up with out/en/welcome.html, out/de/welcome.html, etc., generated once at build time.