Skip to content

[turbopack] Create the JavaScript runtime for Module Federation - #97261

Open
sampoder wants to merge 1 commit into
canaryfrom
sp/turbopack/mf/javascript-runtime
Open

[turbopack] Create the JavaScript runtime for Module Federation#97261
sampoder wants to merge 1 commit into
canaryfrom
sp/turbopack/mf/javascript-runtime

Conversation

@sampoder

@sampoder sampoder commented Aug 12, 2026 •
edited
Loading

Copy link
Copy Markdown
Member

This PR introduces a new runtime that allows Turbopack to engage with module federation.

container.ts contains the equivalents of the get & init APIs mentioned on https://webpack.js.org/concepts/module-federation/.

const catalog = createContainer('catalog', 'default', {
  './Button': async () => () => Button,
})

await catalog.init(sharedDependencies)

const createButtonModule = await catalog.get('./Button')
const buttonModule = createButtonModule()

The PR also introduces loadRemoteModule():

const buttonModule = await loadRemoteModule(
  'catalog',
  'https://example.com/remoteEntry.js',
  './Button'
)

Using this method triggers this flow:

load remoteEntry.js
        ↓
find its container
        ↓
container.init(shared modules)
        ↓
container.get("./Button")
        ↓
run the returned factory
        ↓
receive the Button module

The PR also includes provideShared() and consumeShared() which are Webpack APIs that are being ported over:

provideShared({
  shareKey: 'react',
  version: '19.1.0',
  factory: () => React,
  eager: true,
})
const React = consumeShared({
  shareKey: 'react',
  requiredVersion: '^19.0.0',
  singleton: true,
})

Codex's Webpack comparison

Turbopack file / API Purpose Webpack equivalent
container.ts
createContainer(), container.init(), and container.get()		 Creates a remote container, connects shared dependencies, and returns exposed modules ContainerEntryModule.js
remote-loader.ts
loadScript() and the remote-loading helpers		 Loads remoteEntry.js, finds its container, and requests a module RemoteRuntimeModule.js and LoadScriptRuntimeModule.js
remote-loader.ts
Remote fallback handling		 Tries the configured remote locations until a container can be loaded FallbackModule.js
share-runtime.ts
Share-scope creation, registration, merging, and initialization		 Maintains the collection of dependencies shared between hosts and remotes ShareRuntimeModule.js
provide-shared.ts
provideShared()		 Makes a local dependency and its version available to other applications ProvideSharedModule.js
consume-shared.ts
consumeShared() and consumeSharedAsync()		 Selects and loads an appropriate version of a shared dependency ConsumeSharedRuntimeModule.js
semver.ts
Version parsing and matching		 Implements Webpack-compatible checks such as ^19.0.0 semver.js
remote-scope.ts
Remote request scope tracking		 Carries information through nested remote requests and prevents repeated work RemoteRuntimeModule.js and RuntimeGlobals.currentRemoteGetScope
runtime-state.ts
Shared runtime state and caches		 Deduplicates containers and script loads across Turbopack runtime copies Webpack distributes this state across RuntimeGlobals.js, RemoteRuntimeModule.js, and LoadScriptRuntimeModule.js
runtime.test.ts
Runtime compatibility tests		 Verifies container behavior, shared dependencies, version matching, retries, and fallbacks Webpack’s container and sharing test suites

@github-actions

github-actions Bot commented Aug 12, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Failing CI jobs

Commit: e2b157d | About building and testing Next.js

@github-actions

github-actions Bot commented Aug 12, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Stats from current PR

✅ No significant changes detected

📊 All Metrics
📖 Metrics Glossary

Dev Server Metrics:

  • Listen = TCP port starts accepting connections
  • First Request = HTTP server returns successful response
  • Cold = Fresh build (no cache)
  • Warm = With cached build artifacts

Build Metrics:

  • Fresh = Clean build (no .next directory)
  • Cached = With existing .next directory

Change Thresholds:

  • Time: Changes < 50ms AND < 10%, OR < 2% are insignificant
  • Size: Changes < 1KB AND < 1% are insignificant
  • All other changes are flagged to catch regressions

⚡ Dev Server

Metric Canary PR Change Trend
Cold (Listen) 812ms 811ms ✓ ▂███▁
Cold (Ready in log) 783ms 783ms ✓ ▁██▇▁
Cold (First Request) 1.278s 1.291s ✓ ▁██▇▁
Warm (Listen) 811ms 812ms ✓ ▂██▇▂
Warm (Ready in log) 787ms 778ms ✓ ▁██▇▁
Warm (First Request) 1.258s 1.259s ✓ ▁██▇▁
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 768ms 813ms ✓ ▁▂█▂▁
Cold (Ready in log) 769ms 775ms ✓ ▁▁█▁▁
Cold (First Request) 3.332s 3.416s ✓ ▁▁█▁▁
Warm (Listen) 811ms 812ms ✓ ▁▂█▂▂
Warm (Ready in log) 772ms 772ms ✓ ▁▁█▁▁
Warm (First Request) 3.377s 3.396s ✓ ▁▁█▂▁

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 5.629s 5.652s ✓ ▁██▇▁
Cached Build 2.902s 2.905s ✓ ▁██▇▁
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 24.236s 24.726s ✓ ▁▁█▁▁
Cached Build 23.984s 24.263s ✓ ▁▁█▁▁
node_modules Size 553 MB 553 MB ✓ █████
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles
Canary PR Change
0-qgm0nju2p_g.js gzip 65.6 kB N/A -
03lzpt71kg1qg.js gzip 47 kB N/A -
050icza-xjz0i.js gzip 5.73 kB N/A -
07jdby0ue616s.js gzip 450 B N/A -
09h-pq0amxnxn.js gzip 155 B N/A -
0bjdc8muo74n5.js gzip 8.71 kB N/A -
0cz1d0mv5g_q7.js gzip 39.4 kB 39.4 kB ✓
0d96sdjnk6_q2.js gzip 160 B N/A -
0h65-ko13bi2v.js gzip 154 B N/A -
0l9a54rsx_muy.js gzip 169 B N/A -
0q36apx7b1q_e.js gzip 7.54 kB N/A -
0rci1f3or1a19.js gzip 13.3 kB N/A -
0s56j06e963lv.js gzip 157 B N/A -
0vh9avwq65kiy.js gzip 156 B N/A -
1_2x714--ii1i.js gzip 8.76 kB N/A -
1-3y752pkth5-.js gzip 10 kB N/A -
10l611mm67gac.js gzip 71.6 kB N/A -
1elt1qium-r2m.css gzip 115 B 115 B ✓
1k6dd7su4cfei.js gzip 3.57 kB N/A -
1kpy40fd-pusb.js gzip 154 B N/A -
1tf1phijqlx9j.js gzip 220 B 220 B ✓
1uzabyd1120a1.js gzip 8.71 kB N/A -
2_uglbwqpe26b.js gzip 156 B N/A -
2-ufv8lc-g7gg.js gzip 10.6 kB N/A -
21kmjy_10x14f.js gzip 8.81 kB N/A -
28dhc6t85q1_p.js gzip 8.78 kB N/A -
29vdii-hrinxo.js gzip 154 B N/A -
2f-ilvczue-tp.js gzip 9.46 kB N/A -
2f1u17u5c8iny.js gzip 8.79 kB N/A -
2ikltg_8iegxw.js gzip 10.3 kB N/A -
2vxi673cz1-t4.js gzip 8.79 kB N/A -
38-q43pzktqhs.js gzip 1.46 kB N/A -
3dpw0m5_58h1u.js gzip 160 B N/A -
3gq5gsxwg_yl5.js gzip 151 B N/A -
3mrwxzed0ylgv.js gzip 13.1 kB N/A -
3nbojhxiy1qv_.js gzip 13.7 kB N/A -
3p8f-2kolq65a.js gzip 157 B N/A -
3qmtac2p5up_2.js gzip 156 B N/A -
41u5s3oe2-erp.js gzip 2.29 kB N/A -
445s_9hf8o7ao.js gzip 8.76 kB N/A -
turbopack-0d..9ejy.js gzip 3.74 kB 3.74 kB ✓
0-6bcj16ji2wf.js gzip N/A 10.6 kB -
00i5e2bmvcp3b.js gzip N/A 155 B -
07ryk0jced-sc.js gzip N/A 8.78 kB -
0jwho9fkrb_t3.js gzip N/A 2.29 kB -
0k32-8va-4evm.js gzip N/A 155 B -
0rd26mgng5fzz.js gzip N/A 153 B -
0roh390ijzxa5.js gzip N/A 8.75 kB -
0vex9w55ursqj.js gzip N/A 8.79 kB -
0xnnl2qx2x7bz.js gzip N/A 158 B -
17oe55cu76cd7.js gzip N/A 450 B -
17vqy5qzu8dz5.js gzip N/A 167 B -
1drww5xikb-c-.js gzip N/A 9.46 kB -
1g60xde_dv17t.js gzip N/A 8.79 kB -
1kp8dhziabfib.js gzip N/A 154 B -
1tk8-jw7z6hlb.js gzip N/A 149 B -
1uzv47btzam64.js gzip N/A 5.73 kB -
1vy7n7wxv_rh5.js gzip N/A 8.81 kB -
2_uqyv_-jqnh5.js gzip N/A 65.6 kB -
2-0i7pl900-ou.js gzip N/A 8.71 kB -
2-kcbngm7ik7y.js gzip N/A 8.75 kB -
26zt1nty--7dt.js gzip N/A 155 B -
29p5-xa4jmdhg.js gzip N/A 13.7 kB -
2hzkpmnvy0nyg.js gzip N/A 71.6 kB -
2lpk5_hknut8q.js gzip N/A 13.1 kB -
2o4cibp3awtbw.js gzip N/A 3.56 kB -
2rvrvr5m-ct0q.js gzip N/A 155 B -
2ugc69z0t0ypz.js gzip N/A 1.46 kB -
3-_0ow7671xjh.js gzip N/A 7.55 kB -
36dn8i-_3dnq5.js gzip N/A 10 kB -
3bvjff6jbedao.js gzip N/A 155 B -
3fljpmwcjxqhx.js gzip N/A 10.3 kB -
3fula_ahie2iv.js gzip N/A 160 B -
3gz44skqdlsrb.js gzip N/A 8.71 kB -
3he_ygd-gghew.js gzip N/A 153 B -
3nk46g6u37ekv.js gzip N/A 47 kB -
3t-wn5cs8eke0.js gzip N/A 155 B -
3y9tus7kb5su0.js gzip N/A 13.3 kB -
Total 401 kB 401 kB ✅ -4 B

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 1.05 kB 1.06 kB ✓
Total 1.05 kB 1.06 kB ⚠️ +2 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 876 B 874 B ✓
Total 876 B 874 B ✅ -2 B
Build Cache
Canary PR Change
00000001.sst gzip 16.1 MB 13.9 MB 🟢 2.2 MB (-14%)
00000002.sst gzip 13.8 MB 14.9 MB 🔴 +1.06 MB (+8%)
00000003.sst gzip 12.9 MB 11.4 MB 🟢 1.49 MB (-12%)
00000004.sst gzip 12.3 MB 14.8 MB 🔴 +2.59 MB (+21%)
00000005.sst gzip 2.8 MB 10.2 MB 🔴 +7.39 MB (+264%)
00000006.sst gzip 10.2 MB 2.8 MB 🟢 7.41 MB (-73%)
00000007.sst gzip 59 B 59 B ✓
00000008.meta gzip 89 B 89 B ✓
00000009.meta gzip 298 kB 298 kB ✓
00000010.meta gzip 298 kB 298 kB ✓
00000011.meta gzip 298 kB 298 kB ✓
00000012.sst gzip 52 kB 52.4 kB ✓
00000013.sst gzip 1.83 MB 1.78 MB 🟢 56 kB (-3%)
00000014.sst gzip 59 B 59 B ✓
00000015.meta gzip 116 B 116 B ✓
00000016.meta gzip 326 kB 326 kB ✓
00000017.meta gzip 406 kB 405 kB ✓
00000018.sst gzip 52.5 kB 53.2 kB 🔴 +689 B (+1%)
00000019.sst gzip 1.37 MB 1.39 MB 🔴 +17.7 kB (+1%)
00000020.sst gzip 59 B 59 B ✓
00000021.meta gzip 116 B 116 B ✓
00000022.meta gzip 326 kB 326 kB ✓
00000023.meta gzip 372 kB 372 kB ✓
00000024.sst gzip 52.6 kB 53.3 kB 🔴 +729 B (+1%)
00000025.sst gzip 1.37 MB 1.39 MB 🔴 +17.6 kB (+1%)
00000026.sst gzip 59 B 59 B ✓
00000027.meta gzip 116 B 116 B ✓
00000028.meta gzip 326 kB 326 kB ✓
00000029.meta gzip 372 kB 372 kB ✓
00000030.sst gzip 52 kB 52.5 kB ✓
00000031.sst gzip 1.37 MB 1.39 MB 🔴 +17.7 kB (+1%)
00000032.sst gzip 59 B 59 B ✓
00000033.meta gzip 116 B 116 B ✓
00000034.meta gzip 326 kB 326 kB ✓
00000035.meta gzip 372 kB 372 kB ✓
00000036.sst gzip 52.5 kB 53.2 kB 🔴 +727 B (+1%)
00000037.sst gzip 1.37 MB 1.39 MB 🔴 +17.6 kB (+1%)
00000038.sst gzip 59 B 59 B ✓
00000039.meta gzip 116 B 116 B ✓
00000040.meta gzip 326 kB 326 kB ✓
00000041.meta gzip 372 kB 372 kB ✓
CURRENT gzip 94 B 94 B ✓
LOG gzip 682 B 666 B 🟢 16 B (-2%)
Total 80.1 MB 80.1 MB ✅ -31.6 kB

📦 Webpack

Client

Main Bundles
Canary PR Change
3322-HASH.js gzip 66.2 kB N/A -
4191.HASH.js gzip 169 B N/A -
7920-HASH.js gzip 4.67 kB N/A -
9784-HASH.js gzip 5.63 kB N/A -
b1ad9f4c-HASH.js gzip 63.2 kB N/A -
framework-HASH.js gzip 59.7 kB 59.7 kB ✓
main-app-HASH.js gzip 254 B 253 B ✓
main-HASH.js gzip 40.1 kB 40.1 kB ✓
webpack-HASH.js gzip 1.68 kB 1.68 kB ✓
3577.HASH.js gzip N/A 168 B -
578-HASH.js gzip N/A 66.8 kB -
8590-HASH.js gzip N/A 5.61 kB -
9750-HASH.js gzip N/A 4.68 kB -
a8984546-HASH.js gzip N/A 63.2 kB -
Total 242 kB 242 kB ⚠️ +618 B
Polyfills
Canary PR Change
polyfills-HASH.js gzip 39.4 kB 39.4 kB ✓
Total 39.4 kB 39.4 kB ✓
Pages
Canary PR Change
_app-HASH.js gzip 194 B 193 B ✓
_error-HASH.js gzip 181 B 182 B ✓
css-HASH.js gzip 334 B 331 B ✓
dynamic-HASH.js gzip 1.81 kB 1.81 kB ✓
edge-ssr-HASH.js gzip 255 B 253 B ✓
head-HASH.js gzip 349 B 351 B ✓
hooks-HASH.js gzip 382 B 384 B ✓
image-HASH.js gzip 581 B 582 B ✓
index-HASH.js gzip 260 B 259 B ✓
link-HASH.js gzip 2.48 kB 2.48 kB ✓
routerDirect..HASH.js gzip 317 B 318 B ✓
script-HASH.js gzip 384 B 386 B ✓
withRouter-HASH.js gzip 316 B 315 B ✓
1afbb74e6ecf..834.css gzip 106 B 106 B ✓
Total 7.95 kB 7.96 kB ⚠️ +4 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 129 kB 129 kB ✓
page.js gzip 294 kB 294 kB ✓
Total 423 kB 423 kB ✅ -36 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 617 B 615 B ✓
middleware-r..fest.js gzip 156 B 156 B ✓
middleware.js gzip 45.7 kB 45.5 kB ✓
edge-runtime..pack.js gzip 842 B 842 B ✓
Total 47.3 kB 47.1 kB ✅ -188 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 717 B 718 B ✓
Total 717 B 718 B ⚠️ +1 B
Build Cache
Canary PR Change
0.pack gzip 4.81 MB 4.8 MB 🟢 9.68 kB (0%)
index.pack gzip 121 kB 121 kB ✓
index.pack.old gzip 122 kB 122 kB ✓
Total 5.05 MB 5.04 MB ✅ -9.79 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 375 kB 375 kB ✓
app-page-exp..prod.js gzip 207 kB 207 kB ✓
app-page-tur...dev.js gzip 374 kB 374 kB ✓
app-page-tur..prod.js gzip 207 kB 207 kB ✓
app-page-tur...dev.js gzip 371 kB 371 kB ✓
app-page-tur..prod.js gzip 204 kB 204 kB ✓
app-page.run...dev.js gzip 371 kB 371 kB ✓
app-page.run..prod.js gzip 205 kB 205 kB ✓
app-route-ex...dev.js gzip 82.9 kB 82.9 kB ✓
app-route-ex..prod.js gzip 56.1 kB 56.1 kB ✓
app-route-tu...dev.js gzip 83 kB 83 kB ✓
app-route-tu..prod.js gzip 56.1 kB 56.1 kB ✓
app-route-tu...dev.js gzip 82.5 kB 82.5 kB ✓
app-route-tu..prod.js gzip 55.9 kB 55.9 kB ✓
app-route.ru...dev.js gzip 82.5 kB 82.5 kB ✓
app-route.ru..prod.js gzip 55.8 kB 55.8 kB ✓
dev-validati...dev.js gzip 134 kB 134 kB ✓
dev-validati...dev.js gzip 134 kB 134 kB ✓
dev-validati...dev.js gzip 131 kB 131 kB ✓
dev-validati...dev.js gzip 131 kB 131 kB ✓
dist_client_...dev.js gzip 324 B 324 B ✓
dist_client_...dev.js gzip 326 B 326 B ✓
dist_client_...dev.js gzip 318 B 318 B ✓
dist_client_...dev.js gzip 317 B 317 B ✓
pages-api-tu...dev.js gzip 46.4 kB 46.4 kB ✓
pages-api-tu..prod.js gzip 34.6 kB 34.6 kB ✓
pages-api.ru...dev.js gzip 46.4 kB 46.4 kB ✓
pages-api.ru..prod.js gzip 34.5 kB 34.5 kB ✓
pages-turbo....dev.js gzip 55.2 kB 55.2 kB ✓
pages-turbo...prod.js gzip 40.1 kB 40.1 kB ✓
pages.runtim...dev.js gzip 55.1 kB 55.1 kB ✓
pages.runtim..prod.js gzip 40.1 kB 40.1 kB ✓
server.runti..prod.js gzip 67.1 kB 67.1 kB ✓
use-cache-pr...dev.js gzip 72.6 kB 72.6 kB ✓
use-cache-pr...dev.js gzip 72.6 kB 72.6 kB ✓
use-cache-pr...dev.js gzip 70.8 kB 70.8 kB ✓
use-cache-pr...dev.js gzip 70.8 kB 70.8 kB ✓
Total 4.11 MB 4.11 MB ✓
📎 Tarball URL 
https://vercel-packages.vercel.app/next/commits/e2b157dcd0e4727e64a67dad37e7dffd73c89486/next

Commit: e2b157d

@sampoder
sampoder marked this pull request as ready for review August 12, 2026 18:48
@sampoder sampoder mentioned this pull request Aug 12, 2026
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@sampoder