feat(rsc-demo): add React Server Components federation demo and integrations

.changeset/rsc-demo-integration.md

@@ -0,0 +1,13 @@
+---
+'@module-federation/enhanced': patch
+'@module-federation/manifest': patch
+'@module-federation/metro': patch
+'@module-federation/node': patch
+'@module-federation/react-server-dom-webpack': patch
+'@module-federation/rsbuild-plugin': patch
+'@module-federation/rsc': patch
+'@module-federation/runtime-core': patch
+'@module-federation/sdk': patch
+---
+
+Add RSC demo support and related runtime/build integrations, including RSC package wiring and react-server-dom-webpack compatibility updates.

.github/workflows/build-and-test.yml

@@ -152,6 +152,11 @@ jobs:
     uses: ./.github/workflows/e2e-router.yml
     secrets: inherit
 
+  e2e-rsc:
+    needs: checkout-install
+    uses: ./.github/workflows/e2e-rsc.yml
+    secrets: inherit
+
   e2e-metro:
     needs:
       - checkout-install

.github/workflows/e2e-manifest.yml

@@ -70,9 +70,9 @@ jobs:
           fi
 
       - name: E2E Test for Manifest Demo Development
-        if: steps.check-ci.outputs.run-e2e == 'true'
+        if: steps.check-ci.outputs.affected == 'true'
         run: node tools/scripts/run-manifest-e2e.mjs --mode=dev
 
       - name: E2E Test for Manifest Demo Production
-        if: steps.check-ci.outputs.run-e2e == 'true'
+        if: steps.check-ci.outputs.affected == 'true'
         run: node tools/scripts/run-manifest-e2e.mjs --mode=prod

.github/workflows/e2e-modern-ssr.yml

@@ -69,7 +69,7 @@ jobs:
           fi
 
       - name: E2E Test for Modern.js SSR
-        if: steps.check-ci.outputs.run-e2e == 'true'
+        if: steps.check-ci.outputs.affected == 'true'
         uses: nick-fields/retry@v3
         with:
           max_attempts: 2

.github/workflows/e2e-modern.yml

@@ -70,7 +70,7 @@ jobs:
           fi
 
       - name: E2E Test for ModernJS
-        if: steps.check-ci.outputs.run-e2e == 'true'
+        if: steps.check-ci.outputs.affected == 'true'
         run: npx kill-port --port 4001 && npx nx run-many --target=test:e2e --projects=modernjs --parallel=1 && npx kill-port --port 4001
 
       - name: Kill ports

.github/workflows/e2e-next-dev.yml

@@ -72,5 +72,5 @@ jobs:
           fi
 
       - name: E2E Test for Next.js Dev
-        if: steps.check-ci.outputs.run-e2e == 'true'
+        if: steps.check-ci.outputs.affected == 'true'
         run: node tools/scripts/run-next-e2e.mjs --mode=dev

.github/workflows/e2e-next-prod.yml

@@ -69,5 +69,5 @@ jobs:
           fi
 
       - name: E2E Test for Next.js Prod
-        if: steps.check-ci.outputs.run-e2e == 'true'
+        if: steps.check-ci.outputs.affected == 'true'
         run: node tools/scripts/run-next-e2e.mjs --mode=prod

.github/workflows/e2e-node.yml

@@ -70,5 +70,5 @@ jobs:
           fi
 
       - name: E2E Node Federation
-        if: steps.check-ci.outputs.run-e2e == 'true'
+        if: steps.check-ci.outputs.affected == 'true'
         run: npx nx run-many --target=serve --projects=node-local-remote,node-remote,node-dynamic-remote-new-version,node-dynamic-remote --parallel=10 & echo "done" && sleep 25 && npx nx run-many --target=serve --projects=node-host & sleep 5 && npx wait-on tcp:3333 && npx nx run node-host-e2e:test:e2e

.github/workflows/e2e-router.yml

@@ -70,5 +70,5 @@ jobs:
           fi
 
       - name: E2E Test for Runtime Demo
-        if: steps.check-ci.outputs.run-e2e == 'true'
+        if: steps.check-ci.outputs.affected == 'true'
         run: node tools/scripts/run-router-e2e.mjs --mode=dev

.github/workflows/e2e-rsc.yml

@@ -0,0 +1,87 @@
+# .github/workflows/e2e-rsc.yml
+name: E2E RSC Demo
+
+on:
+  workflow_call:
+
+permissions:
+  contents: read
+
+jobs:
+  e2e-rsc:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Cache Tool Downloads
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache
+          key: ${{ runner.os }}-toolcache-${{ hashFiles('pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-toolcache-
+
+      - name: Set Playwright cache status
+        run: |
+          if [ -d "$HOME/.cache/ms-playwright" ] || [ -d "$HOME/.cache/Cypress" ]; then
+            echo "PLAYWRIGHT_CACHE_HIT=true" >> "$GITHUB_ENV"
+          else
+            echo "PLAYWRIGHT_CACHE_HIT=false" >> "$GITHUB_ENV"
+          fi
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: '10.28.0'
+
+      - name: Setup Node.js 20
+        uses: actions/setup-node@v6
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Set Nx SHA
+        uses: nrwl/nx-set-shas@v3
+
+      - name: Set SKIP_DEVTOOLS_POSTINSTALL environment variable
+        run: echo "SKIP_DEVTOOLS_POSTINSTALL=true" >> "$GITHUB_ENV"
+
+      - name: Install Dependencies
+        run: pnpm install
+
+      - name: Install Playwright Browsers
+        run: pnpm -C apps/rsc-demo/e2e exec playwright install --with-deps chromium
+
+      - name: Run Build for All Packages
+        run: npx nx run-many --targets=build --projects=tag:type:pkg
+
+      - name: Build RSC Demo
+        run: npx nx run rsc-demo:build
+
+      - name: Verify SSR Registry Source (MF Manifest)
+        run: |
+          echo "Checking mf-manifest.ssr.json additionalData.rsc.clientComponents..."
+          node -e "const mf=require('./apps/rsc-demo/app1/build/mf-manifest.ssr.json'); const cc=mf?.additionalData?.rsc?.clientComponents||mf?.rsc?.clientComponents||{}; if(!Object.keys(cc).length){console.error('ERROR: app1 mf-manifest.ssr.json missing rsc.clientComponents'); process.exit(1)}"
+          node -e "const mf=require('./apps/rsc-demo/app2/build/mf-manifest.ssr.json'); const cc=mf?.additionalData?.rsc?.clientComponents||mf?.rsc?.clientComponents||{}; if(!Object.keys(cc).length){console.error('ERROR: app2 mf-manifest.ssr.json missing rsc.clientComponents'); process.exit(1)}"
+          echo "SSR registry verified via mf-manifest.ssr.json in both apps"
+
+      - name: Verify Manifest Files
+        run: |
+          echo "Checking manifest files..."
+          test -f apps/rsc-demo/app1/build/react-client-manifest.json || (echo "ERROR: react-client-manifest.json missing in app1" && exit 1)
+          test -f apps/rsc-demo/app1/build/react-ssr-manifest.json || (echo "ERROR: react-ssr-manifest.json missing in app1" && exit 1)
+          test -f apps/rsc-demo/app1/build/react-server-actions-manifest.json || (echo "ERROR: react-server-actions-manifest.json missing in app1" && exit 1)
+          test -f apps/rsc-demo/app2/build/react-client-manifest.json || (echo "ERROR: react-client-manifest.json missing in app2" && exit 1)
+          test -f apps/rsc-demo/app2/build/react-ssr-manifest.json || (echo "ERROR: react-ssr-manifest.json missing in app2" && exit 1)
+          test -f apps/rsc-demo/app2/build/react-server-actions-manifest.json || (echo "ERROR: react-server-actions-manifest.json missing in app2" && exit 1)
+          echo "All manifest files present"
+
+      - name: Run RSC Tests (Node)
+        run: npx nx run rsc-demo:test:rsc
+
+      - name: Run RSC E2E Tests (Playwright)
+        run: npx nx run rsc-demo:test:e2e

.github/workflows/e2e-runtime.yml

@@ -70,5 +70,5 @@ jobs:
           fi
 
       - name: E2E Test for Runtime Demo
-        if: steps.check-ci.outputs.run-e2e == 'true'
+        if: steps.check-ci.outputs.affected == 'true'
         run: npx kill-port --port 3005,3006,3007 && pnpm run app:runtime:dev & echo "done" && sleep 20 && npx nx run-many --target=test:e2e --projects=3005-runtime-host --parallel=1 && lsof -ti tcp:3005,3006,3007 | xargs kill

.github/workflows/e2e-shared-tree-shaking.yml

@@ -69,9 +69,9 @@ jobs:
           fi
 
       - name: E2E Test for Shared Tree Shaking Demo - Mode runtime-infer
-        if: steps.check-ci.outputs.run-e2e == 'true'
+        if: steps.check-ci.outputs.affected == 'true'
         run: npx kill-port --port 3001,3002 && nx run shared-tree-shaking-no-server-host:test:e2e && lsof -ti tcp:3001,3002 | xargs kill
 
       - name: E2E Test for Shared Tree Shaking Demo - Mode server-calc
-        if: steps.check-ci.outputs.run-e2e == 'true'
+        if: steps.check-ci.outputs.affected == 'true'
         run: npx kill-port --port 3001,3002,3003 && nx run shared-tree-shaking-with-server-host:test:e2e && lsof -ti tcp:3001,3002,3003 | xargs kill

.gitignore

@@ -97,6 +97,9 @@ packages/enhanced/.unpack-cache/**
 packages/enhanced/.codex/**
 packages/enhanced/generated/**
 **/.codex/
-.pnpm-store/
+
+# apps/rsc-demo build-generated bootstrap (server actions)
 apps/rsc-demo/**/build/
 apps/rsc-demo/e2e/test-results/
+
+.pnpm-store/

README.md

@@ -38,6 +38,12 @@ You can consider the module federation capabilities provided by this repository
 
 To get started with Module Federation, see the [Quick Start](https://module-federation.io/guide/start/quick-start.html).
 
+## 🧪 React Server Components (RSC) Demo
+
+This repo includes an experimental RSC + Module Federation reference implementation:
+- Demo app: `apps/rsc-demo/`
+- Architecture notes (with Mermaid diagrams): `RSC_MF_ARCHITECTURE.md`
+
 ## 🧑‍💻 Community
 
 Come and chat with us on [Discussions](https://github.com/module-federation/universe/discussions) or [Discord](https://discord.gg/n69NnT3ACV)! The Module federation team and users are active there, and we're always looking for contributions.