mirror of
https://github.com/resend/react-email.git
synced 2026-09-14 14:18:02 +08:00
Gabriel Miranda
551412c8a2
Co-authored-by: Chris Pennington <cpenn368@gmail.com> Co-authored-by: cpenned <66193019+cpenned@users.noreply.github.com>
28 lines
1.3 KiB
Plaintext
28 lines
1.3 KiB
Plaintext
---
|
|
title: "Building"
|
|
sidebarTitle: "4. Building"
|
|
"og:image": "https://react.email/static/covers/react-email.png"
|
|
description: "How we build each package before publishing"
|
|
---
|
|
|
|
We use [tsup](https://github.com/egoist/tsup) to build most packages. (The only exception for this is the `@react-email/tailwind` package which currently uses `vite` due to a few issues with `tsup` and `tailwindcss`'s bundling.)
|
|
|
|
To build a package run:
|
|
|
|
```bash package/* (ex: package/render)
|
|
pnpm build
|
|
```
|
|
|
|
Building in each package will run `tsup` with a few settings, typically `src/index.ts --format esm,cjs --dts --external react`.
|
|
Tsup handles building both [ESM](https://nodejs.org/api/esm.html) and
|
|
[CJS](https://nodejs.org/docs/latest/api/modules.html) versions along with the type definitions exported from the entry point, `src/index.ts`, without bundling `react`, which can cause issues.
|
|
|
|
### Why build before publishing?
|
|
|
|
We build most of the packages before publishing for a few reasons:
|
|
|
|
1. All the exported types can be imported from the same place the JavaScript is imported
|
|
2. We have proper [CommonJS](https://nodejs.org/docs/latest/api/modules.html#modules-commonjs-modules)
|
|
and [ES Modules](https://nodejs.org/api/esm.html#modules-ecmascript-modules) support
|
|
3. Code that isn't exported is not published or downloaded
|