create-apollo-monorepo 0.5.4 → 0.6.0

package/index.mjs

@@ -409,6 +409,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 +909,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\`.
@@ -1072,7 +1131,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.0",
   "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"