refactor(platform): relocate deploy-target apps under platforms/

Move apps/{vercel,cloudflare} to platforms/{vercel,cloudflare} and
apps/site/vercel.json to platforms/vercel/vercel.json. Rebase all
relative path references across workflows, CODEOWNERS, docs, and
configs so tooling resolves from the new locations.

vercel.json now declares outputDirectory (../../apps/site/.next) so
Vercel can find the Next.js build when its Root Directory is set to
platforms/vercel, and uses build.env for NEXT_PUBLIC_DEPLOY_TARGET and
NODE_OPTIONS=--conditions=vercel instead of cross-env (which is not in
the --prod install tree).

Add NEXT_PUBLIC_DEPLOY_TARGET and NODE_OPTIONS=--conditions=cloudflare
to the Cloudflare deploy workflow's build and deploy step env blocks
so the outer opennextjs-cloudflare process resolves imports under the
cloudflare condition (matching the Playwright workflow).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: ovflowd

.github/CODEOWNERS

@@ -27,10 +27,11 @@ turbo.json @nodejs/nodejs-website @nodejs/web-infra
 crowdin.yml @nodejs/web-infra
 apps/site/redirects.json @nodejs/web-infra
 apps/site/site.json @nodejs/web-infra
-apps/cloudflare/wrangler.jsonc @nodejs/web-infra
-apps/cloudflare/open-next.config.ts @nodejs/web-infra
-apps/cloudflare/next.platform.config.mjs @nodejs/web-infra
-apps/vercel/next.platform.config.mjs @nodejs/web-infra
+platforms/cloudflare/wrangler.jsonc @nodejs/web-infra
+platforms/cloudflare/open-next.config.ts @nodejs/web-infra
+platforms/cloudflare/next.platform.config.mjs @nodejs/web-infra
+platforms/vercel/vercel.json @nodejs/web-infra
+platforms/vercel/next.platform.config.mjs @nodejs/web-infra
 apps/site/redirects.json @nodejs/web-infra
 
 # Critical Documents

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

@@ -51,7 +51,7 @@ jobs:
         run: node_modules/.bin/playwright install --with-deps
 
       - name: Build open-next site
-        working-directory: apps/cloudflare
+        working-directory: platforms/cloudflare
         run: node --run cloudflare:build:worker
         env:
           NEXT_PUBLIC_DEPLOY_TARGET: cloudflare

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

@@ -57,13 +57,18 @@ jobs:
         run: node --run build:blog-data
 
       - name: Build open-next site
-        working-directory: apps/cloudflare
+        working-directory: platforms/cloudflare
         run: node --run cloudflare:build:worker
+        env:
+          NEXT_PUBLIC_DEPLOY_TARGET: cloudflare
+          NODE_OPTIONS: --conditions=cloudflare
 
       - name: Deploy open-next site
-        working-directory: apps/cloudflare
+        working-directory: platforms/cloudflare
         run: node --run cloudflare:deploy
         env:
+          NEXT_PUBLIC_DEPLOY_TARGET: cloudflare
+          NODE_OPTIONS: --conditions=cloudflare
           CF_WORKERS_SCRIPTS_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
           CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
           CLOUDFLARE_ACCOUNT_ID: fb4a2d0f103c6ff38854ac69eb709272

.gitignore

@@ -43,7 +43,7 @@ dist/
 # Cloudflare Build Output
 apps/site/.open-next
 apps/site/.wrangler
-apps/cloudflare/.wrangler
+platforms/cloudflare/.wrangler
 
 ## Playwright
 test-results

apps/vercel/__tests__/next.platform.config.test.mjs

@@ -2,14 +2,14 @@
 
 The Node.js Website can be built using the [OpenNext Cloudflare adapter](https://opennext.js.org/cloudflare). Such build generates a [Cloudflare Worker](https://www.cloudflare.com/en-gb/developer-platform/products/workers/) that can be deployed on the [Cloudflare](https://www.cloudflare.com) network.
 
-The build is gated on the `NEXT_PUBLIC_DEPLOY_TARGET=cloudflare` environment variable (set by the OpenNext `buildCommand`), which makes `apps/site` pull its Next.js, MDX, image-loader, and analytics overrides from [`@node-core/platform-cloudflare`](../apps/cloudflare). See the [Deploy Target Selection](./technologies.md#deploy-target-selection-next_public_deploy_target) section of the Technologies document for the full platform-adapter contract.
+The build is gated on the `NEXT_PUBLIC_DEPLOY_TARGET=cloudflare` environment variable (set by the OpenNext `buildCommand`), which makes `apps/site` pull its Next.js, MDX, image-loader, and analytics overrides from [`@node-core/platform-cloudflare`](../platforms/cloudflare). See the [Deploy Target Selection](./technologies.md#deploy-target-selection-next_public_deploy_target) section of the Technologies document for the full platform-adapter contract.
 
 ## Configurations
 
-All Cloudflare-specific configuration lives in the [`@node-core/platform-cloudflare`](../apps/cloudflare) package. The two key configuration files are:
+All Cloudflare-specific configuration lives in the [`@node-core/platform-cloudflare`](../platforms/cloudflare) package. The two key configuration files are:
 
-- [`apps/cloudflare/wrangler.jsonc`](../apps/cloudflare/wrangler.jsonc) — the Wrangler configuration
-- [`apps/cloudflare/open-next.config.ts`](../apps/cloudflare/open-next.config.ts) — the OpenNext adapter configuration
+- [`platforms/cloudflare/wrangler.jsonc`](../platforms/cloudflare/wrangler.jsonc) — the Wrangler configuration
+- [`platforms/cloudflare/open-next.config.ts`](../platforms/cloudflare/open-next.config.ts) — the OpenNext adapter configuration
 
 ### Wrangler Configuration
 
@@ -19,7 +19,7 @@ For more details, refer to the [Wrangler documentation](https://developers.cloud
 
 Key configurations include:
 
-- `main`: Points to a custom worker entry point ([`apps/cloudflare/src/worker-entrypoint.ts`](../apps/cloudflare/src/worker-entrypoint.ts)) that wraps the OpenNext-generated worker (see [Custom Worker Entry Point](#custom-worker-entry-point) and [Sentry](#sentry) below).
+- `main`: Points to a custom worker entry point ([`platforms/cloudflare/src/worker-entrypoint.ts`](../platforms/cloudflare/src/worker-entrypoint.ts)) that wraps the OpenNext-generated worker (see [Custom Worker Entry Point](#custom-worker-entry-point) and [Sentry](#sentry) below).
 - `account_id`: Specifies the Cloudflare account ID. This is not required for local previews but is necessary for deployments. You can obtain an account ID for free by signing up at [dash.cloudflare.com](https://dash.cloudflare.com/login).
   - This is currently set to `fb4a2d0f103c6ff38854ac69eb709272`, which is the ID of a Cloudflare account controlled by Node.js, and used for testing.
 - `build`: Defines the build command to generate the Node.js filesystem polyfills required for the application to run on Cloudflare Workers. This uses the [`@flarelabs/wrangler-build-time-fs-assets-polyfilling`](https://github.com/flarelabs-net/wrangler-build-time-fs-assets-polyfilling) package.
@@ -54,15 +54,15 @@ Additionally, when deploying, an extra `CF_WORKERS_SCRIPTS_API_TOKEN` environmen
 
 ### Image loader
 
-When deployed on the Cloudflare network a custom image loader is required. The Cloudflare platform config ([`apps/cloudflare/next.platform.config.mjs`](../apps/cloudflare/next.platform.config.mjs)) contributes it via the `images.loaderFile` field, which is merged into the shared Next.js config when `NEXT_PUBLIC_DEPLOY_TARGET=cloudflare` (the variable is set by the OpenNext `buildCommand` in [`open-next.config.ts`](../apps/cloudflare/open-next.config.ts)).
+When deployed on the Cloudflare network a custom image loader is required. The Cloudflare platform config ([`platforms/cloudflare/next.platform.config.mjs`](../platforms/cloudflare/next.platform.config.mjs)) contributes it via the `images.loaderFile` field, which is merged into the shared Next.js config when `NEXT_PUBLIC_DEPLOY_TARGET=cloudflare` (the variable is set by the OpenNext `buildCommand` in [`open-next.config.ts`](../platforms/cloudflare/open-next.config.ts)).
 
-The custom loader can be found at [`apps/cloudflare/src/image-loader.ts`](../apps/cloudflare/src/image-loader.ts).
+The custom loader can be found at [`platforms/cloudflare/src/image-loader.ts`](../platforms/cloudflare/src/image-loader.ts).
 
 For more details on this see: https://developers.cloudflare.com/images/transform-images/integrate-with-frameworks/#global-loader
 
 ### Custom Worker Entry Point
 
-Instead of directly using the OpenNext-generated worker (`.open-next/worker.js`), the application uses a custom worker entry point at [`apps/cloudflare/src/worker-entrypoint.ts`](../apps/cloudflare/src/worker-entrypoint.ts). This allows customizing the worker's behavior before requests are handled (currently used to integrate [Sentry](#sentry) error monitoring).
+Instead of directly using the OpenNext-generated worker (`.open-next/worker.js`), the application uses a custom worker entry point at [`platforms/cloudflare/src/worker-entrypoint.ts`](../platforms/cloudflare/src/worker-entrypoint.ts). This allows customizing the worker's behavior before requests are handled (currently used to integrate [Sentry](#sentry) error monitoring).
 
 The custom entry point imports the OpenNext-generated handler from `.open-next/worker.js` and re-exports the `DOQueueHandler` Durable Object needed by the application.
 

docs/cloudflare-build-and-deployment.md

@@ -302,25 +302,25 @@ Benefits:
 
 `NEXT_PUBLIC_DEPLOY_TARGET` selects which platform adapter contributes its Next.js config, MDX flags, image loader, analytics, and Playwright webServer. It is consumed at build time by [`apps/site/next.config.mjs`](../apps/site/next.config.mjs), [`apps/site/mdx/plugins.mjs`](../apps/site/mdx/plugins.mjs), and [`apps/site/playwright.config.ts`](../apps/site/playwright.config.ts) via a dynamic import of `@node-core/platform-${target}/next.platform.config`.
 
-| Value        | Adapter                                                                                                                                                                                                         | Set by                                                                                     |
-| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
-| `vercel`     | [`@node-core/platform-vercel`](../apps/vercel)                                                                                                                                                                  | [`apps/site/vercel.json`](../apps/site/vercel.json) build env                              |
-| `cloudflare` | [`@node-core/platform-cloudflare`](../apps/cloudflare)                                                                                                                                                          | OpenNext `buildCommand` in [`open-next.config.ts`](../apps/cloudflare/open-next.config.ts) |
-| _(unset)_    | Falls back to the no-op defaults in [`apps/site/next.platform.config.mjs`](../apps/site/next.platform.config.mjs) and [`apps/site/playwright.platform.config.mjs`](../apps/site/playwright.platform.config.mjs) | Plain `pnpm dev` / `pnpm build` / `pnpm deploy`                                            |
+| Value        | Adapter                                                                                                                                                                                                         | Set by                                                                                          |
+| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
+| `vercel`     | [`@node-core/platform-vercel`](../platforms/vercel)                                                                                                                                                             | [`platforms/vercel/vercel.json`](../platforms/vercel/vercel.json) build env                     |
+| `cloudflare` | [`@node-core/platform-cloudflare`](../platforms/cloudflare)                                                                                                                                                     | OpenNext `buildCommand` in [`open-next.config.ts`](../platforms/cloudflare/open-next.config.ts) |
+| _(unset)_    | Falls back to the no-op defaults in [`apps/site/next.platform.config.mjs`](../apps/site/next.platform.config.mjs) and [`apps/site/playwright.platform.config.mjs`](../apps/site/playwright.platform.config.mjs) | Plain `pnpm dev` / `pnpm build` / `pnpm deploy`                                                 |
 
-Each adapter exports a default `{ nextConfig, aliases, images, mdx }` shape (any field optional). See [`apps/vercel/next.platform.config.mjs`](../apps/vercel/next.platform.config.mjs) and [`apps/cloudflare/next.platform.config.mjs`](../apps/cloudflare/next.platform.config.mjs) for reference.
+Each adapter exports a default `{ nextConfig, aliases, images, mdx }` shape (any field optional). See [`platforms/vercel/next.platform.config.mjs`](../platforms/vercel/next.platform.config.mjs) and [`platforms/cloudflare/next.platform.config.mjs`](../platforms/cloudflare/next.platform.config.mjs) for reference.
 
 #### Vercel Integration
 
 - Automatic deployments for branches (ignoring automated branches)
-- Custom install + ignore scripts ([see `vercel.json`](../apps/site/vercel.json))
+- Custom install + ignore scripts ([see `vercel.json`](../platforms/vercel/vercel.json))
 - Build-time dependencies must be in `dependencies`, not `devDependencies`
 - Sponsorship maintained by OpenJS Foundation
 
 #### Cloudflare Integration
 
 - OpenNext adapter builds a [Cloudflare Worker](https://www.cloudflare.com/en-gb/developer-platform/products/workers/) artifact from the Next.js build
-- All Cloudflare-specific files (Wrangler config, OpenNext config, custom worker entrypoint, image loader) live in [`apps/cloudflare`](../apps/cloudflare)
+- All Cloudflare-specific files (Wrangler config, OpenNext config, custom worker entrypoint, image loader) live in [`platforms/cloudflare`](../platforms/cloudflare)
 - See [Cloudflare build and deployment](./cloudflare-build-and-deployment.md) for details
 
 ### Package Management

docs/technologies.md

@@ -8,7 +8,7 @@
  * `apps/site/mdx/plugins.mjs` reads `.mdx` — never drags them into the
  * worker runtime.
  *
- * @type {import('../site/next.platform.config').PlatformConfig}
+ * @type {import('../../apps/site/next.platform.config').PlatformConfig}
  */
 export default {
   aliases: {
@@ -25,16 +25,19 @@ export default {
   },
   nextConfig: async () => {
     const { getDeploymentId } = await import('@opennextjs/cloudflare');
+
     return {
       // Skew protection: Cloudflare routes requests by deploymentId so that
       // a client and the worker stay in sync across rolling deploys.
-      deploymentId: await getDeploymentId(),
+      deploymentId: getDeploymentId(),
     };
   },
   images: async () => {
     const { createRequire } = await import('node:module');
     const { relative } = await import('node:path');
+
     const require = createRequire(import.meta.url);
+
     return {
       // Route optimized images through Cloudflare's Images service via the
       // custom loader. `remotePatterns` do NOT apply here — Cloudflare

apps/cloudflare/next.platform.config.mjs …orms/cloudflare/next.platform.config.mjsapps/cloudflare/next.platform.config.mjs renamed to platforms/cloudflare/next.platform.config.mjs apps/cloudflare/next.platform.config.mjs renamed to platforms/cloudflare/next.platform.config.mjs

@@ -14,12 +14,12 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/nodejs/nodejs.org",
-    "directory": "apps/cloudflare"
+    "directory": "platforms/cloudflare"
   },
   "scripts": {
-    "cloudflare:build:worker": "pnpm --filter=@node-core/website exec opennextjs-cloudflare build --openNextConfigPath ../cloudflare/open-next.config.ts --config ../cloudflare/wrangler.jsonc",
-    "cloudflare:deploy": "pnpm --filter=@node-core/website exec opennextjs-cloudflare deploy --openNextConfigPath ../cloudflare/open-next.config.ts --config ../cloudflare/wrangler.jsonc",
-    "cloudflare:preview": "pnpm --filter=@node-core/website exec wrangler dev --config ../cloudflare/wrangler.jsonc",
+    "cloudflare:build:worker": "pnpm --filter=@node-core/website exec opennextjs-cloudflare build --openNextConfigPath ../../platforms/cloudflare/open-next.config.ts --config ../../platforms/cloudflare/wrangler.jsonc",
+    "cloudflare:deploy": "pnpm --filter=@node-core/website exec opennextjs-cloudflare deploy --openNextConfigPath ../../platforms/cloudflare/open-next.config.ts --config ../../platforms/cloudflare/wrangler.jsonc",
+    "cloudflare:preview": "pnpm --filter=@node-core/website exec wrangler dev --config ../../platforms/cloudflare/wrangler.jsonc",
     "lint:types": "tsc --noEmit"
   },
   "dependencies": {