feat(repack): interactive federation dev runner

.changeset/federation-manifest.md

@@ -0,0 +1,7 @@
+---
+'@callstack/repack': minor
+---
+
+Add an opt-in `manifest` option to both module federation plugins. When set, the build emits `repack-federation-manifest.json` next to the bundle: shared dependencies report the versions actually installed in `node_modules` instead of the `*` range the plugins configure by default, and an additive `reactNative` block lists the native modules found in the module graph. Field shapes follow the upstream `mf-manifest.json` spec, so existing tooling can parse the file as-is. With the option absent, builds are byte-identical to before.
+
+Two commands consume the manifest. `npx react-native federation-manifest <file|dir|url>` prints a human-readable summary of what a host or remote shipped, or the raw document with `--json`. `npx react-native federation-doctor --host <source> --remotes <list>` compares a host manifest against its remotes and reports singleton version drift, `singleton`/`eager` mismatches, unresolvable `requiredVersion` ranges, native modules the host does not declare, and remotes that ship no manifest. It exits 1 on drift and 2 when a check could not run, so it works as a CI gate; `--format json` and `--allow-missing-manifests` cover scripts and gradual rollout.

.gitignore

@@ -389,3 +389,13 @@ packages/**/docs
 
 # watchman
 .watchman-cookie*
+
+# Fixture node_modules for federation manifest / defineShared version tests
+!packages/repack/src/plugins/__tests__/__fixtures__/manifest-context/node_modules/
+!packages/repack/src/utils/__tests__/__fixtures__/define-shared-app/node_modules/
+!packages/repack/src/utils/__tests__/__fixtures__/define-shared-split-app/node_modules/
+!packages/repack/src/commands/federation/__fixtures__/dry-run-workspace/apps/host/node_modules/
+!packages/repack/src/commands/federation/__fixtures__/dry-run-workspace/apps/remote-clean/node_modules/
+!packages/repack/src/commands/federation/__fixtures__/dry-run-workspace/apps/remote-drift/node_modules/
+!packages/repack/src/commands/federation/__fixtures__/init-workspace/apps/host/node_modules/
+!packages/repack/src/commands/federation/__fixtures__/init-workspace/apps/remote-drift/node_modules/

agent_context/README.md

@@ -9,3 +9,4 @@ works, and is kept in sync with the implementation as it evolves.
 | Folder | Topic |
 | --- | --- |
 | [rspackv2-jul2026](./rspackv2-jul2026/design.md) | Dual Rspack 1.x/2.x support |
+| [federation-tools](./federation-tools/design.md) | Federation manifest, doctor, shared-config retrofit, dev runner |

apps/tester-federation-v2/configs/rspack.host-app.mts

@@ -1,8 +1,17 @@
 import * as Repack from '@callstack/repack';
 import rspack from '@rspack/core';
-import reactPkg from 'react/package.json' with { type: 'json' };
-import reactNativePkg from 'react-native/package.json' with { type: 'json' };
-import pkg from '../package.json' with { type: 'json' };
+
+// Shared dependencies are versionless here: defineShared pins every entry to
+// the exact version installed in this workspace, so host and remotes always
+// agree without hand-maintained literals.
+const SHARED_DEPS = [
+  'react',
+  'react-native',
+  '@react-navigation/native',
+  '@react-navigation/native-stack',
+  'react-native-safe-area-context',
+  'react-native-screens',
+];
 
 export default Repack.defineRspackConfig((env) => {
   const { mode, context, platform } = env;
@@ -52,44 +61,10 @@ export default Repack.defineRspackConfig((env) => {
           MiniApp: `MiniApp@http://localhost:8082/${platform}/mf-manifest.json`,
         },
         dts: false,
-        shared: {
-          react: {
-            singleton: true,
-            eager: true,
-            version: reactPkg.version,
-            requiredVersion: reactPkg.version,
-          },
-          'react-native': {
-            singleton: true,
-            eager: true,
-            version: reactNativePkg.version,
-            requiredVersion: reactNativePkg.version,
-          },
-          '@react-navigation/native': {
-            singleton: true,
-            eager: true,
-            version: pkg.dependencies['@react-navigation/native'],
-            requiredVersion: pkg.dependencies['@react-navigation/native'],
-          },
-          '@react-navigation/native-stack': {
-            singleton: true,
-            eager: true,
-            version: pkg.dependencies['@react-navigation/native-stack'],
-            requiredVersion: pkg.dependencies['@react-navigation/native-stack'],
-          },
-          'react-native-safe-area-context': {
-            singleton: true,
-            eager: true,
-            version: pkg.dependencies['react-native-safe-area-context'],
-            requiredVersion: pkg.dependencies['react-native-safe-area-context'],
-          },
-          'react-native-screens': {
-            singleton: true,
-            eager: true,
-            version: pkg.dependencies['react-native-screens'],
-            requiredVersion: pkg.dependencies['react-native-screens'],
-          },
-        },
+        shared: Repack.defineShared(SHARED_DEPS, {
+          context,
+          role: 'host',
+        }),
       }),
       // silence missing @react-native-masked-view optionally required by @react-navigation/elements
       new rspack.IgnorePlugin({

apps/tester-federation-v2/configs/rspack.mini-app.mts

@@ -1,8 +1,17 @@
 import * as Repack from '@callstack/repack';
 import rspack from '@rspack/core';
-import reactPkg from 'react/package.json' with { type: 'json' };
-import reactNativePkg from 'react-native/package.json' with { type: 'json' };
-import pkg from '../package.json' with { type: 'json' };
+
+// Shared dependencies are versionless here: defineShared pins every entry to
+// the exact version installed in this workspace, so host and remotes always
+// agree without hand-maintained literals.
+const SHARED_DEPS = [
+  'react',
+  'react-native',
+  '@react-navigation/native',
+  '@react-navigation/native-stack',
+  'react-native-safe-area-context',
+  'react-native-screens',
+];
 
 export default Repack.defineRspackConfig((env) => {
   const { mode, context, platform } = env;
@@ -49,44 +58,12 @@ export default Repack.defineRspackConfig((env) => {
           './MiniAppNavigator': './src/mini/navigation/MainNavigator',
         },
         dts: false,
-        shared: {
-          react: {
-            singleton: true,
-            eager: false,
-            version: reactPkg.version,
-            requiredVersion: reactPkg.version,
-          },
-          'react-native': {
-            singleton: true,
-            eager: false,
-            version: reactNativePkg.version,
-            requiredVersion: reactNativePkg.version,
-          },
-          '@react-navigation/native': {
-            singleton: true,
-            eager: false,
-            version: pkg.dependencies['@react-navigation/native'],
-            requiredVersion: pkg.dependencies['@react-navigation/native'],
-          },
-          '@react-navigation/native-stack': {
-            singleton: true,
-            eager: false,
-            version: pkg.dependencies['@react-navigation/native-stack'],
-            requiredVersion: pkg.dependencies['@react-navigation/native-stack'],
-          },
-          'react-native-safe-area-context': {
-            singleton: true,
-            eager: false,
-            version: pkg.dependencies['react-native-safe-area-context'],
-            requiredVersion: pkg.dependencies['react-native-safe-area-context'],
-          },
-          'react-native-screens': {
-            singleton: true,
-            eager: false,
-            version: pkg.dependencies['react-native-screens'],
-            requiredVersion: pkg.dependencies['react-native-screens'],
-          },
-        },
+        shared: Repack.defineShared(SHARED_DEPS, {
+          context,
+          role: 'remote',
+          // `--standalone` is runtime-only (env.argv): never committed.
+          mode: env.argv?.standalone ? 'standalone' : 'federated',
+        }),
       }),
       // silence missing @react-native-masked-view optionally required by @react-navigation/elements
       new rspack.IgnorePlugin({

apps/tester-federation-v2/configs/webpack.host-app.mts

@@ -1,9 +1,18 @@
 // @ts-check
 import * as Repack from '@callstack/repack';
-import reactPkg from 'react/package.json' with { type: 'json' };
-import reactNativePkg from 'react-native/package.json' with { type: 'json' };
 import webpack from 'webpack';
-import pkg from '../package.json' with { type: 'json' };
+
+// Shared dependencies are versionless here: defineShared pins every entry to
+// the exact version installed in this workspace, so host and remotes always
+// agree without hand-maintained literals.
+const SHARED_DEPS = [
+  'react',
+  'react-native',
+  '@react-navigation/native',
+  '@react-navigation/native-stack',
+  'react-native-safe-area-context',
+  'react-native-screens',
+];
 
 export default Repack.defineWebpackConfig((env) => {
   const { mode, context, platform } = env;
@@ -48,44 +57,10 @@ export default Repack.defineWebpackConfig((env) => {
           MiniApp: `MiniApp@http://localhost:8082/${platform}/mf-manifest.json`,
         },
         dts: false,
-        shared: {
-          react: {
-            singleton: true,
-            eager: true,
-            version: reactPkg.version,
-            requiredVersion: reactPkg.version,
-          },
-          'react-native': {
-            singleton: true,
-            eager: true,
-            version: reactNativePkg.version,
-            requiredVersion: reactNativePkg.version,
-          },
-          '@react-navigation/native': {
-            singleton: true,
-            eager: true,
-            version: pkg.dependencies['@react-navigation/native'],
-            requiredVersion: pkg.dependencies['@react-navigation/native'],
-          },
-          '@react-navigation/native-stack': {
-            singleton: true,
-            eager: true,
-            version: pkg.dependencies['@react-navigation/native-stack'],
-            requiredVersion: pkg.dependencies['@react-navigation/native-stack'],
-          },
-          'react-native-safe-area-context': {
-            singleton: true,
-            eager: true,
-            version: pkg.dependencies['react-native-safe-area-context'],
-            requiredVersion: pkg.dependencies['react-native-safe-area-context'],
-          },
-          'react-native-screens': {
-            singleton: true,
-            eager: true,
-            version: pkg.dependencies['react-native-screens'],
-            requiredVersion: pkg.dependencies['react-native-screens'],
-          },
-        },
+        shared: Repack.defineShared(SHARED_DEPS, {
+          context,
+          role: 'host',
+        }),
       }),
       // silence missing @react-native-masked-view optionally required by @react-navigation/elements
       new webpack.IgnorePlugin({

apps/tester-federation-v2/configs/webpack.mini-app.mts

@@ -1,8 +1,17 @@
 import * as Repack from '@callstack/repack';
-import reactPkg from 'react/package.json' with { type: 'json' };
-import reactNativePkg from 'react-native/package.json' with { type: 'json' };
 import webpack from 'webpack';
-import pkg from '../package.json' with { type: 'json' };
+
+// Shared dependencies are versionless here: defineShared pins every entry to
+// the exact version installed in this workspace, so host and remotes always
+// agree without hand-maintained literals.
+const SHARED_DEPS = [
+  'react',
+  'react-native',
+  '@react-navigation/native',
+  '@react-navigation/native-stack',
+  'react-native-safe-area-context',
+  'react-native-screens',
+];
 
 export default Repack.defineWebpackConfig((env) => {
   const { mode, context, platform } = env;
@@ -47,44 +56,12 @@ export default Repack.defineWebpackConfig((env) => {
           './MiniAppNavigator': './src/mini/navigation/MainNavigator',
         },
         dts: false,
-        shared: {
-          react: {
-            singleton: true,
-            eager: false,
-            version: reactPkg.version,
-            requiredVersion: reactPkg.version,
-          },
-          'react-native': {
-            singleton: true,
-            eager: false,
-            version: reactNativePkg.version,
-            requiredVersion: reactNativePkg.version,
-          },
-          '@react-navigation/native': {
-            singleton: true,
-            eager: false,
-            version: pkg.dependencies['@react-navigation/native'],
-            requiredVersion: pkg.dependencies['@react-navigation/native'],
-          },
-          '@react-navigation/native-stack': {
-            singleton: true,
-            eager: false,
-            version: pkg.dependencies['@react-navigation/native-stack'],
-            requiredVersion: pkg.dependencies['@react-navigation/native-stack'],
-          },
-          'react-native-safe-area-context': {
-            singleton: true,
-            eager: false,
-            version: pkg.dependencies['react-native-safe-area-context'],
-            requiredVersion: pkg.dependencies['react-native-safe-area-context'],
-          },
-          'react-native-screens': {
-            singleton: true,
-            eager: false,
-            version: pkg.dependencies['react-native-screens'],
-            requiredVersion: pkg.dependencies['react-native-screens'],
-          },
-        },
+        shared: Repack.defineShared(SHARED_DEPS, {
+          context,
+          role: 'remote',
+          // `--standalone` is runtime-only (env.argv): never committed.
+          mode: env.argv?.standalone ? 'standalone' : 'federated',
+        }),
       }),
       // silence missing @react-native-masked-view optionally required by @react-navigation/elements
       new webpack.IgnorePlugin({

apps/tester-federation-v2/package.json

@@ -7,8 +7,8 @@
     "ios": "react-native run-ios --no-packager",
     "pods": "(cd ios && bundle install && (bundle exec pod install || bundle exec pod update))",
     "pods:update": "(cd ios && bundle install && bundle exec pod update)",
-    "start:hostapp": "react-native webpack-start --config config.host-app.mts",
-    "start:miniapp": "react-native webpack-start --config config.mini-app.mts --port 8082"
+    "start": "react-native federation-dev",
+    "start:dry": "react-native federation-dev --dry-run"
   },
   "dependencies": {
     "@callstack/repack": "workspace:*",

apps/tester-federation-v2/repack-federation.json

@@ -0,0 +1,17 @@
+{
+  "host": {
+    "root": ".",
+    "manifest": "build/host-app/ios",
+    "config": "config.host-app.mts",
+    "port": 8081
+  },
+  "remotes": {
+    "MiniApp": {
+      "root": ".",
+      "manifest": "build/mini-app/ios",
+      "standalone": true,
+      "port": 8082,
+      "config": "config.mini-app.mts"
+    }
+  }
+}