create-apollo-monorepo 0.9.989 → 0.9.992

package/README.md

@@ -107,6 +107,41 @@ pnpm backend:update  # git submodule update --remote --merge apps/backend
 Don't edit files inside `apps/backend` — open issues / PRs against the
 `apollo-cms` repository upstream.
 
+### Scaffolds created before v0.9.991
+
+Two entries were missing from older scaffolds, and `pnpm dev` fails during
+`plugins:build` without them:
+
+```
+error: Could not resolve: "ioredis"
+error: Could not resolve: "@opentelemetry/api"
+```
+
+`apps/backend/plugins/*` has to be listed in the root `pnpm-workspace.yaml`
+(apollo-cms's own workspace file is ignored once the submodule is a package of
+an outer workspace, so the built-in plugins' dependencies never install), and
+`@opentelemetry/api` has to be a root devDependency (bun's bundler resolves
+`next`'s guarded `require()` of this optional peer, which pnpm — unlike bun —
+does not install). Patch an existing scaffold with:
+
+```yaml
+# pnpm-workspace.yaml
+packages:
+  - 'apps/*'
+  - 'apps/cms-plugins/*'
+  - 'apps/backend/plugins/*'   # add this
+```
+
+```jsonc
+// package.json
+"devDependencies": {
+  "concurrently": "^9.0.0",
+  "@opentelemetry/api": "^1.9.0"   // add this
+}
+```
+
+then re-run `pnpm install`.
+
 ## Deploying to production
 
 The scaffold pins `packageManager: "pnpm@11.0.0"` so Corepack picks the right

package/index.mjs

@@ -389,6 +389,14 @@ function writeRootPackageJson(targetDir, dirName) {
     },
     devDependencies: {
       concurrently: "^9.0.0",
+      // Optional peer of `next` (and `@better-auth/core`). Nothing imports it
+      // eagerly at runtime, but `bun build` resolves every `require()` it can
+      // see — including the guarded one in next/dist/server/lib/trace/tracer.js
+      // — so an uninstalled optional peer fails the plugin bundle with
+      // `error: Could not resolve: "@opentelemetry/api"`. bun install pulls
+      // optional peers in automatically, which is why apollo-cms standalone
+      // never hits this; pnpm skips them, so the monorepo must ask for it.
+      "@opentelemetry/api": "^1.9.0",
     },
     // Pin to pnpm 11 because `pnpm-workspace.yaml` uses the `allowBuilds`
     // map format introduced in v11 (deprecated `onlyBuiltDependencies` is
@@ -451,6 +459,13 @@ function writePnpmWorkspace(targetDir) {
     "packages:",
     "  - 'apps/*'",
     "  - 'apps/cms-plugins/*'",
+    // apollo-cms declares `plugins/*` in its own pnpm-workspace.yaml, but a
+    // nested workspace file is ignored once the submodule is itself a package
+    // of an outer workspace. Without this glob pnpm never installs the
+    // built-in plugins' dependencies, and `plugins:build` dies with
+    // `error: Could not resolve: "ioredis"` (apollo-api-cache) before the
+    // backend can start.
+    "  - 'apps/backend/plugins/*'",
     "",
     "allowBuilds:",
     "  '@parcel/watcher': true",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-apollo-monorepo",
-  "version": "0.9.989",
+  "version": "0.9.992",
   "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"