refactor(platform): collapse @platform aliases into a single wildcard

Replace the per-file `@platform/analytics`, `@platform/instrumentation`,
and `@platform/next.config.mjs` aliases (duplicated across each platform
package) with a single `'@platform' -> PLATFORM_ALIAS` mapping wired in
the root `apps/site/next.config.mjs` for both Turbopack and webpack. Drop
the `aliases` field from `PlatformConfig` and from each platform's
`next.config.mjs`. Add `playwright` scripts to the cloudflare and vercel
platform packages (env baked in via cross-env), simplify the cloudflare
playwright workflow to invoke them, rename `playwright.config.ts` ->
`playwright.config.mjs`, and move `cross-env` into `dependencies` on
`@node-core/platform-vercel` so Vercel's `pnpm install --prod` keeps it.

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

Author: ovflowd

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

@@ -55,10 +55,8 @@ jobs:
         run: node --run build:cloudflare
 
       - name: Run Playwright tests
-        working-directory: apps/site
+        working-directory: platforms/cloudflare
         run: node --run playwright
-        env:
-          NEXT_PUBLIC_DEPLOY_TARGET: cloudflare
 
       - name: Upload Playwright test results
         if: always()

apps/site/next.config.mjs

@@ -4,20 +4,28 @@ import createNextIntlPlugin from 'next-intl/plugin';
 
 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 { DEPLOY_TARGET, PLATFORM_ALIAS } 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`
-);
+/**
+ * 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).
+ *
+ * @type {{ default: import('./next.platform.config.d.ts').PlatformConfig }}
+ */
+const { default: platform } = await import(`${PLATFORM_ALIAS}/next.config.mjs`);
 
 const platformImages = await platform.images?.();
 const platformNextConfig = await platform.nextConfig?.();
 
+// Single wildcard alias: `@platform/<file>` resolves to
+// `@node-core/platform-${DEPLOY_TARGET}/<file>` so each deploy target's
+// files (analytics slot, instrumentation, MDX/Shiki config) are picked
+// up automatically without per-file mappings.
+const platformAliases = { '@platform': PLATFORM_ALIAS };
+
 /** @type {import('next').NextConfig} */
 const nextConfig = {
   // Full Support of React 18 SSR and Streaming
@@ -29,7 +37,7 @@ const nextConfig = {
   basePath: BASE_PATH,
   images: getImagesConfig(platformImages),
   serverExternalPackages: ['twoslash'],
-  transpilePackages: [`@node-core/platform-${DEPLOY_TARGET}`],
+  transpilePackages: [PLATFORM_ALIAS],
   outputFileTracingIncludes: {
     // Twoslash needs TypeScript declarations to function, and, by default, Next.js
     // strips them for brevity. Therefore, they must be explicitly included.
@@ -82,13 +90,13 @@ const nextConfig = {
     turbopackFileSystemCacheForDev: true,
   },
   // Provide Turbopack Aliases for Platform Resolution
-  turbopack: { resolveAlias: platform.aliases },
+  turbopack: { resolveAlias: platformAliases },
   // Provide Webpack Aliases for Platform Resolution.
   webpack: ({ resolve, ...config }) => ({
     ...config,
     resolve: {
       ...resolve,
-      alias: { ...resolve.alias, ...platform.aliases },
+      alias: { ...resolve.alias, ...platformAliases },
       conditionNames: resolve.conditionNames
         .concat(DEPLOY_TARGET)
         .filter(Boolean),

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

@@ -8,11 +8,6 @@ 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
@@ -21,7 +16,6 @@ type PlatformNextConfig = Pick<NextConfig, 'deploymentId' | 'env'>;
  * worker runtime free of build-only code.
  */
 export type PlatformConfig = {
-  aliases?: Record<string, string>;
   images?: () => Promise<NextConfig['images']>;
   mdx?: PlatformMdxConfig;
   nextConfig?: () => Promise<PlatformNextConfig>;

apps/site/next.platform.constants.mjs

@@ -13,3 +13,10 @@
  * @type {'vercel' | 'cloudflare' | 'default'}
  */
 export const DEPLOY_TARGET = process.env.NEXT_PUBLIC_DEPLOY_TARGET ?? 'default';
+
+/**
+ * The alias for the platform.
+ *
+ * @type {string}
+ */
+export const PLATFORM_ALIAS = `@node-core/platform-${DEPLOY_TARGET}`;

apps/site/playwright.config.ts apps/site/playwright.config.mjsapps/site/playwright.config.ts renamed to apps/site/playwright.config.mjs

@@ -1,12 +1,16 @@
 import { defineConfig, devices } from '@playwright/test';
 
-import { DEPLOY_TARGET } from './next.platform.constants.mjs';
+import { PLATFORM_ALIAS } from './next.platform.constants.mjs';
 
-// Playwright loads this config via Node, so resolve the active platform
-// via a dynamic import keyed on `DEPLOY_TARGET` rather than a
-// `@platform/*` alias (those only resolve inside Turbopack/webpack).
+/**
+ * Playwright loads this config via Node, so resolve the active platform
+ * via a dynamic import keyed on `DEPLOY_TARGET` rather than a
+ * `@platform/*` alias (those only resolve inside Turbopack/webpack).
+ *
+ * @type {{ default: import('./playwright.platform.config.d.ts').PlatformPlaywrightConfig }}
+ */
 const { default: platform } = await import(
-  `@node-core/platform-${DEPLOY_TARGET}/playwright.config.mjs`
+  `${PLATFORM_ALIAS}/playwright.config.mjs`
 );
 
 const isCI = !!process.env.CI;

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

@@ -2,7 +2,7 @@ import type { PlaywrightTestConfig } from '@playwright/test';
 
 /**
  * Shared Playwright platform-config contract consumed by
- * `apps/site/playwright.config.ts` and implemented by each
+ * `apps/site/playwright.config.mjs` and implemented by each
  * `@node-core/platform-<target>` package.
  */
 export type PlatformPlaywrightConfig = Pick<

platforms/cloudflare/next.config.mjs

@@ -4,13 +4,6 @@
  * @type {import('../../apps/site/next.platform.config').PlatformConfig}
  */
 export default {
-  aliases: {
-    '@platform/analytics': '@node-core/platform-cloudflare/analytics.tsx',
-    '@platform/instrumentation':
-      '@node-core/platform-cloudflare/instrumentation.ts',
-    '@platform/next.config.mjs':
-      '@node-core/platform-cloudflare/next.config.mjs',
-  },
   mdx: {
     // Cloudflare workers can't load `shiki/wasm` via `WebAssembly.instantiate`
     // with custom imports (blocked for security), so fall back to the

platforms/cloudflare/package.json

@@ -15,7 +15,8 @@
     "build:cloudflare": "cross-env NEXT_PUBLIC_DEPLOY_TARGET=cloudflare pnpm --filter=@node-core/website exec opennextjs-cloudflare build --openNextConfigPath ../../platforms/cloudflare/open-next.config.ts --config ../../platforms/cloudflare/wrangler.jsonc",
     "deploy:cloudflare": "cross-env NEXT_PUBLIC_DEPLOY_TARGET=cloudflare pnpm --filter=@node-core/website exec opennextjs-cloudflare deploy --openNextConfigPath ../../platforms/cloudflare/open-next.config.ts --config ../../platforms/cloudflare/wrangler.jsonc",
     "dev:cloudflare": "pnpm --filter=@node-core/website exec wrangler dev --config ../../platforms/cloudflare/wrangler.jsonc",
-    "lint:types": "tsc --noEmit"
+    "lint:types": "tsc --noEmit",
+    "playwright": "cross-env NEXT_PUBLIC_DEPLOY_TARGET=cloudflare pnpm --filter=@node-core/website playwright"
   },
   "dependencies": {
     "@flarelabs-net/wrangler-build-time-fs-assets-polyfilling": "^0.0.1",

platforms/default/next.config.mjs

@@ -4,12 +4,6 @@
  * @type {import('../../apps/site/next.platform.config').PlatformConfig}
  */
 export default {
-  aliases: {
-    '@platform/analytics': '@node-core/platform-default/analytics.tsx',
-    '@platform/instrumentation':
-      '@node-core/platform-default/instrumentation.ts',
-    '@platform/next.config.mjs': '@node-core/platform-default/next.config.mjs',
-  },
   mdx: {
     // Defaults for local dev / static export / generic hosting. Platform
     // packages override these via their own `next.config.mjs`.

platforms/vercel/next.config.mjs

@@ -4,12 +4,6 @@
  * @type {import('../../apps/site/next.platform.config').PlatformConfig}
  */
 export default {
-  aliases: {
-    '@platform/analytics': '@node-core/platform-vercel/analytics.tsx',
-    '@platform/instrumentation':
-      '@node-core/platform-vercel/instrumentation.ts',
-    '@platform/next.config.mjs': '@node-core/platform-vercel/next.config.mjs',
-  },
   mdx: {
     // Vercel supports the fast Oniguruma WASM engine and twoslash transforms,
     // so keep parity with the default standalone config.