create-apollo-monorepo 0.2.0 → 0.3.1

package/index.mjs

@@ -325,9 +325,47 @@ function writeRootPackageJson(targetDir, dirName) {
       "backend:setup": "pnpm --filter ./apps/backend setup",
     },
     engines: { node: ">=20", pnpm: ">=9" },
-    packageManager: "pnpm@9.0.0",
+    pnpm: {
+      // apollo-cms transitively pulls multiple esbuild versions (0.18, 0.25, 0.27).
+      // pnpm's binary symlink can pick the wrong platform binary for esbuild's
+      // postinstall version check, failing with "Expected X.Y.Z but got A.B.C".
+      // Allow listed packages to run their build/postinstall scripts; the rest
+      // are skipped (pnpm 10 default is empty allow-list).
+      onlyBuiltDependencies: [
+        "@swc/core",
+        "@swc/core-darwin-arm64",
+        "@swc/core-darwin-x64",
+        "@swc/core-linux-arm64-gnu",
+        "@swc/core-linux-x64-gnu",
+        "esbuild",
+        "msw",
+        "sharp",
+        "unrs-resolver",
+        "@rolldown/binding-darwin-arm64",
+        "@rolldown/binding-linux-x64-gnu",
+        "@rolldown/binding-linux-arm64-gnu",
+        "better-sqlite3",
+        "core-js",
+        "core-js-pure",
+      ],
+    },
   };
   writeFileSync(resolve(targetDir, "package.json"), JSON.stringify(pkg, null, 2) + "\n");
+
+  // .npmrc — keep peer-deps lenient and hoist esbuild's platform binaries so
+  // its postinstall version check resolves the correct one across nested
+  // dependency trees.
+  writeFileSync(
+    resolve(targetDir, ".npmrc"),
+    [
+      "auto-install-peers=true",
+      "strict-peer-dependencies=false",
+      "public-hoist-pattern[]=*esbuild*",
+      "public-hoist-pattern[]=*types*",
+      "shell-emulator=true",
+      "",
+    ].join("\n"),
+  );
 }
 
 function writePnpmWorkspace(targetDir) {
@@ -540,6 +578,20 @@ export default config;
     resolve(dir, ".gitignore"),
     ["node_modules", ".next", "dist", ".env.local", ""].join("\n"),
   );
+
+  // Vercel project config for the frontend. Skip cron + region pinning is
+  // optional; configure Root Directory + "Include all submodules" in the
+  // Vercel UI when linking the project.
+  const vercelJson = {
+    $schema: "https://openapi.vercel.sh/vercel.json",
+    regions: ["sin1"],
+  };
+  writeFileSync(resolve(dir, "vercel.json"), JSON.stringify(vercelJson, null, 2) + "\n");
+
+  writeFileSync(
+    resolve(dir, ".vercelignore"),
+    ["node_modules", ".next", ".env.local", ""].join("\n"),
+  );
 }
 
 function writeReadme(targetDir, dirName, frontendName, assetPrefix) {
@@ -629,6 +681,71 @@ Do **not** edit files inside \`apps/backend\`. Open issues / PRs in the
 
 Shared dev env lives in the root \`.env.local\`. The backend reads its own
 \`apps/backend/.env.local\` (already populated by the installer).
+
+## Deploy on Vercel
+
+Two Vercel projects, one repo. Each project picks up its own Root Directory.
+
+### 1) Backend project
+
+- **Import** this repo into Vercel as a new project.
+- **Root Directory**: \`apps/backend\`
+- **Build Command**: \`cd ../.. && pnpm install --frozen-lockfile && pnpm --filter ./apps/backend build\`
+- **Install Command**: leave empty (handled in build)
+- **Settings → Git → Include all submodules: ON** (Vercel checks out an empty \`apps/backend\` otherwise)
+- **Environment variables**:
+  \`\`\`
+  DATABASE_URL=postgresql://…
+  APOLLO_SECRET=<openssl rand -hex 32>
+  NEXT_PUBLIC_SITE_URL=https://yourdomain.com   # the PUBLIC origin
+  NEXT_PUBLIC_DEFAULT_LOCALE=en
+  ${singleOrigin ? `APOLLO_ASSET_PREFIX=${assetPrefix}` : "# APOLLO_ASSET_PREFIX=/cms-assets   # only when single-origin"}
+  CRON_SECRET=<random>                          # protects /api/cron
+  # Storage on Vercel cannot use local FS — pick one:
+  # Vercel Blob:        BLOB_READ_WRITE_TOKEN=…
+  # S3 / R2 / Spaces:   S3_ACCESS_KEY_ID, S3_SECRET_ACCESS_KEY, S3_BUCKET, S3_REGION, S3_ENDPOINT
+  APOLLO_DISABLE_LOCAL_STORAGE=1
+  \`\`\`
+- **Cron**: \`apps/backend/vercel.json\` declares \`/api/cron\` on a 5-minute schedule (from apollo-cms upstream).
+
+### 2) Frontend project
+
+- **Import the same repo** as a separate Vercel project.
+- **Root Directory**: \`apps/frontend\`
+- **Build Command**: \`cd ../.. && pnpm install --frozen-lockfile && pnpm --filter ./apps/frontend build\`
+- **Install Command**: leave empty
+- **Settings → Git → Include all submodules: ON**
+- **Environment variables**:
+  \`\`\`
+  NEXT_PUBLIC_SITE_URL=https://yourdomain.com
+${singleOrigin
+  ? `  BACKEND_INTERNAL_URL=https://<your-backend>.vercel.app\n  NEXT_PUBLIC_APOLLO_ASSET_PREFIX=${assetPrefix}`
+  : `  NEXT_PUBLIC_BACKEND_URL=https://<your-backend>.vercel.app`
+}
+  \`\`\`
+
+### 3) Custom domain
+
+Attach \`yourdomain.com\` to the **frontend** project${singleOrigin ? " (in single-origin mode it's the public entry point)" : ""}. The backend stays on its \`*.vercel.app\` URL${singleOrigin ? " — that's what the rewrite proxies to" : ""}.
+
+### 4) Skip duplicate builds (optional)
+
+Each push triggers both projects to rebuild. Add an **Ignored Build Step** in
+each project's Settings → Git:
+
+- **Backend**: \`git diff HEAD^ HEAD --quiet -- apps/backend\` (exits 0 → skip build)
+- **Frontend**: \`git diff HEAD^ HEAD --quiet -- apps/frontend\`
+
+### Gotchas
+
+- **Submodule must be initialized** on Vercel — the "Include all submodules"
+  toggle is the most common reason builds fail with a missing \`apps/backend\`.
+- **OAuth callbacks** for email providers must use the public domain:
+  \`https://yourdomain.com/api/email/oauth/callback\`.${singleOrigin ? " The frontend rewrite forwards it to the backend." : ""}
+- **Cron** runs on the backend project only. Vercel sends \`Authorization:
+  Bearer $CRON_SECRET\` automatically when \`CRON_SECRET\` is set.${singleOrigin ? `
+- **Better Auth** uses \`trustedProxyHeaders: true\` so the rewrite proxy's
+  \`x-forwarded-host\` lands cookies at the public origin without extra config.` : ""}
 `;
   writeFileSync(resolve(targetDir, "README.md"), readme);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-apollo-monorepo",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Scaffold a monorepo with a frontend app and Apollo CMS as a git submodule backend (single-origin via Next.js rewrites + assetPrefix)",
   "bin": {
     "create-apollo-monorepo": "index.mjs"