create-apollo-monorepo 0.5.4 → 0.6.1

package/index.mjs

@@ -352,6 +352,11 @@ function writeRootPackageJson(targetDir, dirName) {
       // `pnpm setup` is pnpm's CLI bootstrap built-in — must use `run` to
       // forward to the workspace's setup script (apollo-cms's db:push + db:seed).
       "backend:setup": "pnpm --filter ./apps/backend run setup",
+      // Full apollo-cms upgrade pipeline: drizzle push + replay
+      // src/upgrades/0.1.*.ts data migrations + seed. Run this after
+      // `pnpm backend:update` so any data-migration step from the new
+      // apollo-cms version is applied — `backend:setup` alone skips it.
+      "backend:upgrade": "pnpm --filter ./apps/backend exec bun run upgrade",
     },
     devDependencies: {
       concurrently: "^9.0.0",
@@ -409,6 +414,58 @@ function writePnpmWorkspace(targetDir) {
   );
 }
 
+// Single-origin nginx reference. Only emitted when adminPrefix is set, since
+// in separate-origins mode the two apps live on their own domains/ports and
+// don't need the prefix-aware location ordering.
+function writeNginxSample(targetDir, adminPrefix) {
+  const prefix = adminPrefix || "/admin";
+  const conf = `# Apollo CMS — single-origin nginx sample.
+# Mirrors apps/frontend/next.config.ts rewrites (frontend :3001 / backend :3000).
+# No caching headers — Next.js sets its own. Add SSL + HTTP→HTTPS in production.
+
+upstream apollo_frontend { server 127.0.0.1:3001; }
+upstream apollo_backend  { server 127.0.0.1:3000; }
+
+server {
+    listen      80;
+    server_name _;
+
+    client_max_body_size 50m;
+
+    proxy_http_version 1.1;
+    proxy_set_header   Host              $host;
+    proxy_set_header   X-Real-IP         $remote_addr;
+    proxy_set_header   X-Forwarded-For   $proxy_add_x_forwarded_for;
+    proxy_set_header   X-Forwarded-Proto $scheme;
+    proxy_set_header   X-Forwarded-Host  $host;
+
+    # Backend — admin UI + chunks (APOLLO_ASSET_PREFIX=${prefix}), media, Sentry tunnel
+    location =  ${prefix}    { proxy_pass http://apollo_backend; }
+    location ^~ ${prefix}/   { proxy_pass http://apollo_backend; }
+    location ^~ /uploads/    { proxy_pass http://apollo_backend; }
+    location =  /monitoring  { proxy_pass http://apollo_backend; }
+
+    # Backend SSE — long-lived, no buffering
+    location ^~ /api/editing-presence/ {
+        proxy_pass         http://apollo_backend;
+        proxy_buffering    off;
+        proxy_read_timeout 24h;
+    }
+
+    # Backend APIs (mirror the list in apps/frontend/next.config.ts).
+    # \`editing-presence\` is included so the bare path also routes to backend;
+    # streaming sub-paths still match the \`^~\` block above first.
+    location ~ ^/api/(auth|v1|cron|email|health|mcp|admin|editing-presence)(/|$) {
+        proxy_pass http://apollo_backend;
+    }
+
+    # Frontend — everything else
+    location / { proxy_pass http://apollo_frontend; }
+}
+`;
+  writeFileSync(resolve(targetDir, "nginx.conf.sample"), conf);
+}
+
 function writeRootGitignore(targetDir) {
   const ignore = [
     "node_modules",
@@ -857,6 +914,13 @@ paths to the backend so /_next/* doesn't collide:
 The frontend MUST NOT define routes at \`/admin\`, \`/api/auth\`, \`/api/v1\`, etc.
 If you need your own API, namespace it under \`/api/internal/*\` or similar.
 
+### Reverse proxy (nginx)
+
+A reference \`nginx.conf.sample\` ships at the repo root with the same routing
+baked in (frontend on :3001, backend on :3000). Use it when fronting both apps
+behind a single TLS-terminating proxy outside Vercel — drop in your domain and
+SSL certs.
+
 To **disable** single-origin and run the backend on its own subdomain,
 delete \`APOLLO_ASSET_PREFIX\` from \`apps/backend/.env.local\` and remove the
 \`rewrites()\` block from \`apps/frontend/next.config.ts\`.
@@ -944,12 +1008,20 @@ folder + \`plugin.json#name\`.
 
 ## Updating the backend
 
-Apollo CMS is tracked as a git submodule. Pull the latest:
+Apollo CMS is tracked as a git submodule. Full upgrade flow:
 
 \`\`\`bash
-pnpm backend:update
+pnpm backend:update    # fast-forward apps/backend to the latest apollo-cms commit
+pnpm install           # in case the submodule changed package.json
+pnpm backend:upgrade   # drizzle push + replay version migrations + seed
 \`\`\`
 
+| Script | What it does |
+| --- | --- |
+| \`pnpm backend:update\`  | \`git submodule update --remote --merge apps/backend\` — code only |
+| \`pnpm backend:setup\`   | First-time bootstrap: \`db:push\` + \`db:seed\` only |
+| \`pnpm backend:upgrade\` | Full pipeline: \`db:push\` + replay \`src/upgrades/0.1.*.ts\` data migrations + \`db:seed\`. **Use this** after \`backend:update\` — \`backend:setup\` skips the data-migration phase. |
+
 Do **not** edit files inside \`apps/backend\`. Open issues / PRs in the
 \`apollo-cms\` repository upstream.
 
@@ -1072,7 +1144,12 @@ async function main() {
   writeRootGitignore(targetDir);
   writeRootEnv(targetDir, { dbUrl, siteUrl, locale, authSecret, cronSecret, adminPrefix, backendInternalUrl });
   writeReadme(targetDir, dirName, frontendName, adminPrefix);
-  success("package.json, pnpm-workspace.yaml, .gitignore, .env.local, README.md");
+  if (adminPrefix) writeNginxSample(targetDir, adminPrefix);
+  success(
+    `package.json, pnpm-workspace.yaml, .gitignore, .env.local, README.md${
+      adminPrefix ? ", nginx.conf.sample" : ""
+    }`,
+  );
 
   // ── Step 4: git init ──
   step(4, "Initializing git");

package/package.json

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