feat(root): development workflow for all components (#2295)

gabrielmfern · web-flow · commit 72e6cf4bfafb · 2025-07-01T10:18:29.000-03:00
diff --git a/package.json b/package.json
@@ -4,15 +4,14 @@
   "private": true,
   "scripts": {
     "build": "turbo run build",
-    "dev": "turbo run dev --parallel --concurrency 25",
-    "release": "turbo run build --filter=./packages/* && pnpm changeset publish",
     "canary:enter": "changeset pre enter canary",
     "canary:exit": "changeset pre exit",
-    "version": "changeset version && pnpm install --no-frozen-lockfile && pnpm lint:fix",
     "lint": "biome check",
     "lint:fix": "biome check --write .",
+    "release": "turbo run build --filter=./packages/* && pnpm changeset publish",
     "test": "turbo run test",
-    "test:watch": "turbo run test:watch"
+    "test:watch": "turbo run test:watch",
+    "version": "changeset version && pnpm install --no-frozen-lockfile && pnpm lint:fix"
   },
   "devDependencies": {
     "@biomejs/biome": "2.0.5",
diff --git a/packages/body/package.json b/packages/body/package.json
@@ -24,10 +24,10 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "peerDependencies": {
     "react": "^18.0 || ^19.0 || ^19.0.0-rc"
diff --git a/packages/button/package.json b/packages/button/package.json
@@ -24,10 +24,10 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "repository": {
     "type": "git",
diff --git a/packages/code-block/package.json b/packages/code-block/package.json
@@ -24,8 +24,8 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
-    "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch"
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
+    "clean": "rm -rf dist"
   },
   "repository": {
     "type": "git",
diff --git a/packages/code-inline/package.json b/packages/code-inline/package.json
@@ -23,9 +23,9 @@
   },
   "license": "MIT",
   "scripts": {
-    "dev": "pnpm build --watch",
-    "clean": "rm -rf dist",
-    "build": "tsup src/index.ts --format esm,cjs --dts --external react"
+    "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
+    "clean": "rm -rf dist"
   },
   "engines": {
     "node": ">=18.0.0"
diff --git a/packages/column/package.json b/packages/column/package.json
@@ -24,10 +24,10 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "repository": {
     "type": "git",
diff --git a/packages/components/package.json b/packages/components/package.json
@@ -24,8 +24,8 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
-    "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch"
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
+    "clean": "rm -rf dist"
   },
   "repository": {
     "type": "git",
diff --git a/packages/container/package.json b/packages/container/package.json
@@ -24,10 +24,10 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "repository": {
     "type": "git",
diff --git a/packages/font/package.json b/packages/font/package.json
@@ -24,10 +24,10 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "peerDependencies": {
     "react": "^18.0 || ^19.0 || ^19.0.0-rc"
diff --git a/packages/head/package.json b/packages/head/package.json
@@ -24,10 +24,10 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "repository": {
     "type": "git",
diff --git a/packages/heading/package.json b/packages/heading/package.json
@@ -24,10 +24,10 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "repository": {
     "type": "git",
diff --git a/packages/hr/package.json b/packages/hr/package.json
@@ -24,10 +24,10 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "repository": {
     "type": "git",
diff --git a/packages/html/package.json b/packages/html/package.json
@@ -24,10 +24,10 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "repository": {
     "type": "git",
diff --git a/packages/img/package.json b/packages/img/package.json
@@ -24,10 +24,10 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "repository": {
     "type": "git",
diff --git a/packages/link/package.json b/packages/link/package.json
@@ -24,10 +24,10 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "repository": {
     "type": "git",
diff --git a/packages/markdown/package.json b/packages/markdown/package.json
@@ -23,10 +23,10 @@
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "keywords": [
     "react",
diff --git a/packages/preview/package.json b/packages/preview/package.json
@@ -24,10 +24,10 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "repository": {
     "type": "git",
diff --git a/packages/react-email/package.json b/packages/react-email/package.json
@@ -8,8 +8,8 @@
   "type": "module",
   "scripts": {
     "build": "tsup-node",
+    "build:watch": "tsup-node --watch src",
     "clean": "rm -rf dist",
-    "dev": "tsup-node --watch src",
     "test": "vitest run",
     "test:watch": "vitest"
   },
diff --git a/packages/render/package.json b/packages/render/package.json
@@ -66,8 +66,8 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup-node",
+    "build:watch": "tsup-node --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup-node --watch",
     "test": "vitest run",
     "test:watch": "vitest"
   },
diff --git a/packages/row/package.json b/packages/row/package.json
@@ -24,10 +24,10 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "repository": {
     "type": "git",
diff --git a/packages/section/package.json b/packages/section/package.json
@@ -24,10 +24,10 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "repository": {
     "type": "git",
diff --git a/packages/tailwind/package.json b/packages/tailwind/package.json
@@ -24,10 +24,10 @@
   "license": "MIT",
   "scripts": {
     "build": "tsc && NODE_ENV=production vite build --mode production && node ./copy-tailwind-types.mjs",
-    "dev": "vite build --watch",
+    "build:watch": "vite build --watch",
     "clean": "rm -rf dist",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "repository": {
     "type": "git",
diff --git a/packages/text/package.json b/packages/text/package.json
@@ -24,10 +24,10 @@
   "license": "MIT",
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external react",
+    "build:watch": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --external react --watch",
-    "test:watch": "vitest",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "repository": {
     "type": "git",
diff --git a/playground/README.md b/playground/README.md
@@ -0,0 +1,40 @@
+# React Email Playground
+
+This is a playground for React Email made to experiment with components in realtime.
+
+It includes all components directly from source with a path alias import of `@react-email/components` and hot reloading in the `dev` script.
+
+## Development workflow
+
+### 1. Create an email template
+
+Create a new file at `playground/emails/testing.tsx` 
+
+```tsx emails/testing.tsx
+import { Html, Head, Body, Tailwind, Text } from '@react-email/components';
+
+export default function Testing() {
+  return <Tailwind>
+    <Html>
+      <Head/>
+
+      <Body className="bg-black text-white">
+        <Text className="m-0 my-4 bg-cyan-200 text-slate-800">
+          This is a testing email template.
+        </Text>
+      </Body>
+    </Html>
+  </Tailwind>;
+}
+```
+
+### 2. Run playground server
+
+```sh
+pnpm dev
+```
+
+### 3. Open in your browser
+
+Go to http://localhost:3000
+
diff --git a/playground/components.ts b/playground/components.ts
@@ -0,0 +1,19 @@
+export * from '../packages/body/src';
+export * from '../packages/button/src';
+export * from '../packages/code-block/src';
+export * from '../packages/code-inline/src';
+export * from '../packages/column/src';
+export * from '../packages/container/src';
+export * from '../packages/font/src';
+export * from '../packages/head/src';
+export * from '../packages/heading/src';
+export * from '../packages/hr/src';
+export * from '../packages/html/src';
+export * from '../packages/img/src';
+export * from '../packages/link/src';
+export * from '../packages/markdown/src';
+export * from '../packages/preview/src';
+export * from '../packages/row/src';
+export * from '../packages/section/src';
+export * from '../packages/tailwind/src';
+export * from '../packages/text/src';
diff --git a/playground/emails/.gitignore b/playground/emails/.gitignore
@@ -0,0 +1,2 @@
+**/*.tsx
+!example.tsx
diff --git a/playground/emails/example.tsx b/playground/emails/example.tsx
diff --git a/playground/package.json b/playground/package.json
diff --git a/playground/tsconfig.json b/playground/tsconfig.json
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
