refactor: split site into site/vercel/cloudflare apps

Separates platform concerns so Next.js upgrades and Vercel-specific deps
are no longer gated on OpenNext's compatibility window (and vice versa),
and so each deployment ships only the dependencies it actually uses.

- apps/site: platform-neutral. No @vercel/*, no @opennextjs/cloudflare,
  no VERCEL_ENV or 'Cloudflare' in global runtime forks.
- apps/vercel: owns Analytics, SpeedInsights, OTel instrumentation,
  vercel.json.
- apps/cloudflare: owns OpenNext, Wrangler, image loader, worker
  entrypoint (Sentry), version_metadata binding.

Host apps reach site source via git-tracked symlinks, plus one real
parallel-route slot per host (app/[locale]/@analytics/default.tsx) for
platform-specific layout injection. MDX engine choice moved from a
runtime 'Cloudflare' in global check to MDX_WASM / MDX_TWOSLASH build
env vars. middleware.ts renamed to proxy.ts on the Vercel/standalone
side; Cloudflare keeps middleware.ts (OpenNext requirement) via symlink.

Commands: pnpm build/dev/start still target site. Platform commands are
now pnpm build:vercel, build:cloudflare, dev:vercel, dev:cloudflare,
cloudflare:preview, cloudflare:deploy. Vercel project Root Directory
needs to move to apps/vercel in the Vercel dashboard when this ships.

All three apps pass lint:types independently.

Author: ovflowd

.github/PULL_REQUEST_TEMPLATE.md

@@ -28,5 +28,5 @@ You can check the items by adding an `x` between the brackets, like this: `[x]`
 - [ ] I have read the [Contributing Guidelines](https://github.com/nodejs/nodejs.org/blob/main/CONTRIBUTING.md) and made commit messages that follow the guideline.
 - [ ] I have run `pnpm format` to ensure the code follows the style guide.
 - [ ] I have run `pnpm test` to check if all tests are passing.
-- [ ] I have run `pnpm build` to check if the website builds without errors.
+- [ ] I have run `pnpm build` to check if the website builds without errors. (Optional: `pnpm build:vercel` / `pnpm build:cloudflare` for deployment-target-specific builds.)
 - [ ] I've covered new added functionality with unit tests if necessary.

.github/workflows/build.yml

@@ -55,21 +55,37 @@ jobs:
 
       - uses: actions/cache@668228422ae6a00e4ad889ee87cd7109ec5666a7 # v5.0.4
         with:
-          path: ${{ github.workspace }}/apps/site/.next/cache
+          path: |
+            ${{ github.workspace }}/apps/site/.next/cache
+            ${{ github.workspace }}/apps/vercel/.next/cache
+            ${{ github.workspace }}/apps/cloudflare/.next/cache
           key: ${{ runner.os }}-nextjs-${{ hashFiles('**/pnpm-lock.yaml') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
           restore-keys: ${{ runner.os }}-nextjs-${{ hashFiles('**/pnpm-lock.yaml') }}-
 
-      - name: Build Next.js
+      - name: Build apps/site (standalone)
         # We want a ISR build on CI to ensure that regular Next.js builds work as expected.
-        run: node_modules/.bin/turbo build --cache-dir=.turbo/cache
+        run: node_modules/.bin/turbo build --filter=@node-core/website --cache-dir=.turbo/cache
         env:
-          # We want to ensure we have enough RAM allocated to the Node.js process
-          # this should be a last resort in case by any chances the build memory gets too high
-          # but in general this should never happen
           NODE_OPTIONS: '--max_old_space_size=4096'
-          # See https://github.com/vercel/next.js/pull/81318
           TURBOPACK_STATS: ${{ matrix.os == 'ubuntu-latest' }}
 
+      - name: Build apps/vercel (Vercel deployment target)
+        # Ensures the Vercel deployment target builds with its platform-specific
+        # `@analytics` slot + instrumentation wired through the shared site source.
+        run: node_modules/.bin/turbo build --filter=@node-core/website-vercel --cache-dir=.turbo/cache
+        env:
+          NODE_OPTIONS: '--max_old_space_size=4096'
+          TURBOPACK_STATS: ${{ matrix.os == 'ubuntu-latest' }}
+
+      - name: Build apps/cloudflare (Cloudflare / OpenNext deployment target)
+        # Ensures the Cloudflare deployment target builds with its Cloudflare
+        # Images loader and MDX_WASM=false Shiki path.
+        # Windows skip: OpenNext/wrangler asset polyfilling is POSIX-only.
+        if: matrix.os == 'ubuntu-latest'
+        run: node_modules/.bin/turbo cloudflare:build:worker --filter=@node-core/website-cloudflare --cache-dir=.turbo/cache
+        env:
+          NODE_OPTIONS: '--max_old_space_size=4096'
+
       - uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0
         if: matrix.os == 'ubuntu-latest'
         with:
@@ -78,11 +94,8 @@ jobs:
 
       - name: Build Next.js (Static Export)
         # We want to generate a static build, as it is a requirement of our website.
-        run: node_modules/.bin/turbo deploy --cache-dir=.turbo/cache
+        run: node_modules/.bin/turbo deploy --filter=@node-core/website --cache-dir=.turbo/cache
         env:
-          # We want to ensure we have enough RAM allocated to the Node.js process
-          # this should be a last resort in case by any chances the build memory gets too high
-          # but in general this should never happen
           NODE_OPTIONS: '--max_old_space_size=4096'
           # We want to ensure that static exports for all locales do not occur on `pull_request` events
           # TODO: The output of this is too large, and it crashes the GitHub Runner

.github/workflows/playwright-cloudflare-open-next.yml

@@ -36,7 +36,7 @@ jobs:
 
       - name: Get Playwright version
         id: playwright-version
-        working-directory: apps/site
+        working-directory: apps/cloudflare
         run: echo "version=$(node_modules/.bin/playwright --version | awk '{print $2}')" >> $GITHUB_OUTPUT
 
       - name: Cache Playwright browsers
@@ -47,11 +47,11 @@ jobs:
           key: playwright-${{ runner.os }}-${{ steps.playwright-version.outputs.version }}
 
       - name: Install Playwright Browsers
-        working-directory: apps/site
+        working-directory: apps/cloudflare
         run: node_modules/.bin/playwright install --with-deps
 
       - name: Run Playwright tests
-        working-directory: apps/site
+        working-directory: apps/cloudflare
         run: node --run playwright
         env:
           PLAYWRIGHT_RUN_CLOUDFLARE_PREVIEW: true
@@ -62,4 +62,4 @@ jobs:
         uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0
         with:
           name: playwright-report
-          path: apps/site/playwright-report/
+          path: apps/cloudflare/playwright-report/

.github/workflows/playwright.yml

@@ -44,7 +44,7 @@ jobs:
 
       - name: Get Playwright version
         id: playwright-version
-        working-directory: apps/site
+        working-directory: apps/vercel
         run: echo "version=$(node_modules/.bin/playwright --version | awk '{print $2}')" >> $GITHUB_OUTPUT
 
       - name: Cache Playwright browsers
@@ -55,11 +55,11 @@ jobs:
           key: playwright-${{ runner.os }}-${{ steps.playwright-version.outputs.version }}
 
       - name: Install Playwright Browsers
-        working-directory: apps/site
+        working-directory: apps/vercel
         run: node_modules/.bin/playwright install --with-deps
 
       - name: Run Playwright tests
-        working-directory: apps/site
+        working-directory: apps/vercel
         run: node --run playwright
         env:
           PLAYWRIGHT_BASE_URL: ${{ steps.deployment.outputs.url }}
@@ -69,4 +69,4 @@ jobs:
         uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0
         with:
           name: playwright-report
-          path: apps/site/playwright-report/
+          path: apps/vercel/playwright-report/

.github/workflows/tmp-cloudflare-open-next-deploy.yml

@@ -57,11 +57,11 @@ jobs:
         run: node --run build:blog-data
 
       - name: Build open-next site
-        working-directory: apps/site
+        working-directory: apps/cloudflare
         run: node --run cloudflare:build:worker
 
       - name: Deploy open-next site
-        working-directory: apps/site
+        working-directory: apps/cloudflare
         run: node --run cloudflare:deploy
         env:
           CF_WORKERS_SCRIPTS_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}

.gitignore

@@ -9,10 +9,10 @@ npm-debug.log
 package-lock.json
 
 # Next.js Build Output
-apps/site/.next
-apps/site/build
 apps/site/public/blog-data.json
-apps/site/next-env.d.ts
+apps/*/build
+apps/*/.next
+apps/*/next-env.d.ts
 
 # Test Runner
 junit.xml

apps/cloudflare/app/[locale]/@analytics/default.tsx

@@ -0,0 +1,5 @@
+import type { FC } from 'react';
+
+const CloudflareAnalytics: FC = () => null;
+
+export default CloudflareAnalytics;

apps/cloudflare/app/[locale]/[...path]

@@ -0,0 +1 @@
+../../../../site/app/[locale]/[...path]

apps/cloudflare/app/[locale]/blog

@@ -0,0 +1 @@
+../../../../site/app/[locale]/blog

apps/cloudflare/app/[locale]/download

@@ -0,0 +1 @@
+../../../../site/app/[locale]/download