refactor(platform): rename platform scripts and add default platform package

Rename platform build/dev/deploy scripts to suffixed names (build:cloudflare,
build:vercel, dev:cloudflare, dev:vercel, deploy:cloudflare) so they no longer
collide with Turbo's ^build cascade. Add a platforms/default package as the
standalone baseline (analytics noop, instrumentation, playwright, next config),
matching the same shape as the cloudflare and vercel packages. Drop the per-
platform turbo.json files in favor of a root lint:types task.

Co-Authored-By: Claude Opus 4.7 <[email protected]>

Author: ovflowd

.github/CODEOWNERS

@@ -29,9 +29,9 @@ apps/site/redirects.json @nodejs/web-infra
 apps/site/site.json @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/cloudflare/next.config.mjs @nodejs/web-infra
 platforms/vercel/vercel.json @nodejs/web-infra
-platforms/vercel/next.platform.config.mjs @nodejs/web-infra
+platforms/vercel/next.config.mjs @nodejs/web-infra
 
 # Critical Documents
 LICENSE @nodejs/tsc

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

@@ -52,17 +52,13 @@ jobs:
 
       - name: Build open-next site
         working-directory: platforms/cloudflare
-        run: node --run cloudflare:build:worker
-        env:
-          NEXT_PUBLIC_DEPLOY_TARGET: cloudflare
-          NODE_OPTIONS: --conditions=cloudflare
+        run: node --run build:cloudflare
 
       - name: Run Playwright tests
         working-directory: apps/site
         run: node --run playwright
         env:
           NEXT_PUBLIC_DEPLOY_TARGET: cloudflare
-          NODE_OPTIONS: --conditions=cloudflare
 
       - name: Upload Playwright test results
         if: always()

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

@@ -58,17 +58,12 @@ jobs:
 
       - name: Build open-next site
         working-directory: platforms/cloudflare
-        run: node --run cloudflare:build:worker
-        env:
-          NEXT_PUBLIC_DEPLOY_TARGET: cloudflare
-          NODE_OPTIONS: --conditions=cloudflare
+        run: node --run build:cloudflare
 
       - name: Deploy open-next site
         working-directory: platforms/cloudflare
-        run: node --run cloudflare:deploy
+        run: node --run deploy:cloudflare
         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

apps/site/mdx/plugins.mjs

@@ -1,14 +1,13 @@
 'use strict';
 
 import rehypeShikiji from '@node-core/rehype-shiki/plugin';
+import platform from '@platform/next.config.mjs';
 import remarkHeadings from '@vcarl/remark-headings';
 import rehypeAutolinkHeadings from 'rehype-autolink-headings';
 import rehypeSlug from 'rehype-slug';
 import remarkGfm from 'remark-gfm';
 import readingTime from 'remark-reading-time';
 
-import platform from '#platform/next.platform.config.mjs';
-
 import remarkTableTitles from '../util/table';
 
 // Shiki is created out here to avoid an async rehype plugin

apps/site/next.config.mjs

@@ -2,20 +2,22 @@
 
 import createNextIntlPlugin from 'next-intl/plugin';
 
-import platform from '#platform/next.platform.config.mjs';
-
 import { BASE_PATH, ENABLE_STATIC_EXPORT } from './next.constants.mjs';
 import { getImagesConfig } from './next.image.config.mjs';
 import { DEPLOY_TARGET } from './next.platform.constants.mjs';
 import { redirects, rewrites } from './next.rewrites.mjs';
 
+// Loaded by Node directly (Next.js doesn't bundle `next.config.mjs`), so
+// we resolve the active platform via a dynamic import keyed on
+// `DEPLOY_TARGET` rather than a `@platform/*` alias (those only resolve
+// inside Turbopack/webpack).
+const { default: platform } = await import(
+  `@node-core/platform-${DEPLOY_TARGET}/next.config.mjs`
+);
+
 const platformImages = await platform.images?.();
 const platformNextConfig = await platform.nextConfig?.();
 
-const transpilePackages = DEPLOY_TARGET
-  ? [`@node-core/platform-${DEPLOY_TARGET}`]
-  : [];
-
 /** @type {import('next').NextConfig} */
 const nextConfig = {
   // Full Support of React 18 SSR and Streaming
@@ -27,7 +29,7 @@ const nextConfig = {
   basePath: BASE_PATH,
   images: getImagesConfig(platformImages),
   serverExternalPackages: ['twoslash'],
-  transpilePackages,
+  transpilePackages: [`@node-core/platform-${DEPLOY_TARGET}`],
   outputFileTracingIncludes: {
     // Twoslash needs TypeScript declarations to function, and, by default, Next.js
     // strips them for brevity. Therefore, they must be explicitly included.
@@ -81,10 +83,7 @@ const nextConfig = {
   },
   // Provide Turbopack Aliases for Platform Resolution
   turbopack: { resolveAlias: platform.aliases },
-  // Provide Webpack Aliases for Platform Resolution. The active deployment
-  // target is also surfaced to the resolver via `conditionNames` so that
-  // `#platform/*` subpath imports in `package.json` pick the matching
-  // branch when webpack bundles server code.
+  // Provide Webpack Aliases for Platform Resolution.
   webpack: ({ resolve, ...config }) => ({
     ...config,
     resolve: {

apps/site/next.constants.mjs

@@ -32,7 +32,7 @@ export const ENABLE_STATIC_EXPORT_LOCALE =
  * The full canonical URL of the deployed Website (used e.g. for the RSS feed).
  *
  * Platform-specific base URLs (such as Vercel's `VERCEL_URL`) are inlined into
- * `NEXT_PUBLIC_BASE_URL` at build time by each platform's `next.platform.config.mjs`,
+ * `NEXT_PUBLIC_BASE_URL` at build time by each platform's `next.config.mjs`,
  * keeping this module free of platform-specific branches.
  */
 export const BASE_URL =

apps/site/next.platform.config.d.ts

@@ -8,6 +8,11 @@ type PlatformNextConfig = Pick<NextConfig, 'deploymentId' | 'env'>;
  * Shared platform-config contract consumed by `apps/site/next.config.mjs`
  * and implemented by each `@node-core/platform-<target>` package.
  *
+ * `aliases` are surfaced as Turbopack/webpack aliases so that
+ * `@platform/*` imports in bundled code (e.g. the `@analytics/`
+ * parallel-route slot, `instrumentation.ts`, `mdx/plugins.mjs`) resolve
+ * to the active platform's files.
+ *
  * `nextConfig` and `images` are async thunks so that platform modules
  * that depend on Node-only tooling (e.g. `@opennextjs/cloudflare`,
  * `require.resolve`) can keep those imports out of the module's

apps/site/next.platform.constants.mjs

@@ -10,6 +10,6 @@
  * The `NEXT_PUBLIC_` prefix makes Next.js inline the value at build time,
  * enabling dead-code elimination of platform-specific branches.
  *
- * @type {'vercel' | 'cloudflare' | undefined}
+ * @type {'vercel' | 'cloudflare' | 'default'}
  */
-export const DEPLOY_TARGET = process.env.NEXT_PUBLIC_DEPLOY_TARGET;
+export const DEPLOY_TARGET = process.env.NEXT_PUBLIC_DEPLOY_TARGET ?? 'default';

apps/site/package.json

@@ -98,6 +98,7 @@
   },
   "peerDependencies": {
     "@node-core/platform-cloudflare": "workspace:*",
+    "@node-core/platform-default": "workspace:*",
     "@node-core/platform-vercel": "workspace:*"
   },
   "peerDependenciesMeta": {
@@ -106,6 +107,9 @@
     },
     "@node-core/platform-vercel": {
       "optional": true
+    },
+    "@node-core/platform-default": {
+      "optional": true
     }
   },
   "imports": {
@@ -117,12 +121,7 @@
       "./*/index.ts",
       "./*.mjs",
       "./*/index.mjs"
-    ],
-    "#platform/*": {
-      "cloudflare": "@node-core/platform-cloudflare/*",
-      "vercel": "@node-core/platform-vercel/*",
-      "default": "./platform/*"
-    }
+    ]
   },
   "engines": {
     "node": "24.x"