Skip to content

[turbopack] Generate Module Federation containers - #97262

Open
sampoder wants to merge 1 commit into
sp/turbopack/mf/javascript-runtimefrom
sp/turbopack/mf/container-generation
Open

[turbopack] Generate Module Federation containers#97262
sampoder wants to merge 1 commit into
sp/turbopack/mf/javascript-runtimefrom
sp/turbopack/mf/container-generation

Conversation

@sampoder

@sampoder sampoder commented Aug 12, 2026 •
edited
Loading

Copy link
Copy Markdown
Member

This PR takes a configuration for module federation passed into Turbopack and generates calls to the runtime created in #97261. For example:

 exposes: {
    './Button': './components/Button',
  }

Would transform to:

import { createContainer } from '@vercel/turbopack-module-federation/container'

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

export const get = container.get
export const init = container.init

This is then the remoteEntry.js ^ and is done by container_entry_source().

We also have remote_proxy_source() which takes this import:

const { Button } = await import('remote/Button')

And instead imports from a generated module:

import { loadRemoteModuleFromFallbacks } from '@vercel/turbopack-module-federation/remote-loader'

const remoteModule = await loadRemoteModuleFromFallbacks(
  [
    {
      name: 'checkout',
      url: 'https://example.com/remoteEntry.js',
      shareScope: 'default',
    },
  ],
  './Button'
)

TURBOPACK_EXPORT_NAMESPACE(remoteModule)

When sharing a module the share-er generates this module:

import * as react from 'react'
import { provideShared } from '@vercel/turbopack-module-federation/provide-shared'

provideShared({
  shareScope: 'default',
  shareKey: 'react',
  version: react.version ?? '0',
  factory: () => react,
  eager: true,
  from: 'catalog',
})

This gets bundled into a chunk on every page that is executed.

And for the remote that intends to reuse this shared module we now generate the following module for loading from the host:

import { consumeSharedAsync } from '@vercel/turbopack-module-federation/consume-shared'

const sharedModule = await consumeSharedAsync({
  shareScope: 'default',
  shareKey: 'react',
  singleton: true,
  strictVersion: false,
  eager: true,
})

TURBOPACK_EXPORT_NAMESPACE(sharedModule)

There's also a fallback for using the local copy:

import * as fallback from 'react'

const sharedModule = await consumeSharedAsync({
  shareKey: 'react',
  fallback: () => fallback,
})
import * as importedNamespace from 'react'

TURBOPACK_EXPORT_NAMESPACE(importedNamespace)

@sampoder sampoder changed the title sp/turbopack/mf/container generation [turbopack] Generate Module Federation containers Aug 12, 2026
@github-actions

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

Copy link
Copy Markdown
Contributor

Stats from current PR

🟢 1 improvement

Metric Canary PR Change Trend
Webpack Build Time (cached) 25.018s 24.184s 🟢 834ms (-3%) █▁▁▁▂
📊 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) 813ms 813ms ✓ ██▁▂▂
Cold (Ready in log) 801ms 791ms ✓ █▇▁▁▁
Cold (First Request) 1.336s 1.323s ✓ █▇▁▂▁
Warm (Listen) 814ms 813ms ✓ █▇▂▂▂
Warm (Ready in log) 805ms 798ms ✓ █▇▁▁▁
Warm (First Request) 1.337s 1.315s ✓ █▇▁▁▁
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 813ms 812ms ✓ █▂▁▂▂
Cold (Ready in log) 786ms 789ms ✓ █▁▁▁▂
Cold (First Request) 3.438s 3.471s ✓ █▁▁▁▂
Warm (Listen) 815ms 813ms ✓ █▂▂▂▂
Warm (Ready in log) 789ms 797ms ✓ █▁▁▂▂
Warm (First Request) 3.423s 3.461s ✓ █▂▁▁▂

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 6.306s 6.392s ✓ █▇▁▂▁
Cached Build 3.011s 3.067s ✓ █▇▁▂▁
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 24.938s 24.732s ✓ █▁▁▁▂
Cached Build 25.018s 24.184s 🟢 834ms (-3%) █▁▁▁▂
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 13 MB 13.5 MB 🔴 +470 kB (+4%)
00000002.sst gzip 12.6 MB 15.3 MB 🔴 +2.63 MB (+21%)
00000003.sst gzip 13.3 MB 11.7 MB 🟢 1.69 MB (-13%)
00000004.sst gzip 16.1 MB 14.7 MB 🟢 1.37 MB (-9%)
00000005.sst gzip 2.8 MB 10.2 MB 🔴 +7.39 MB (+264%)
00000006.sst gzip 10.2 MB 2.8 MB 🟢 7.4 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.3 kB 52.1 kB ✓
00000013.sst gzip 1.81 MB 1.83 MB 🔴 +18.8 kB (+1%)
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 53 kB 52.7 kB ✓
00000019.sst gzip 1.39 MB 1.39 MB 🔴 +2.53 kB (+0%)
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 53.1 kB 52.8 kB ✓
00000025.sst gzip 1.39 MB 1.39 MB 🔴 +4.41 kB (+0%)
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.5 kB 52.2 kB ✓
00000031.sst gzip 1.39 MB 1.39 MB 🔴 +4.17 kB (+0%)
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.9 kB 52.7 kB ✓
00000037.sst gzip 1.39 MB 1.39 MB 🔴 +4.41 kB (+0%)
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 678 B 661 B 🟢 17 B (-3%)
Total 80.1 MB 80.2 MB ⚠️ +63.8 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 253 B 252 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 ⚠️ +15 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.9 kB 45.7 kB ✓
edge-runtime..pack.js gzip 842 B 842 B ✓
Total 47.5 kB 47.3 kB ✅ -231 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 🟢 5.84 kB (0%)
index.pack gzip 122 kB 122 kB ✓
index.pack.old gzip 121 kB 122 kB ✓
Total 5.05 MB 5.04 MB ✅ -4.86 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/b79d26f3eab704c23af814e6296ff94b09907633/next

Commit: b79d26f

@github-actions

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

Copy link
Copy Markdown
Contributor

Failing CI jobs

Commit: b79d26f | About building and testing Next.js

@sampoder
sampoder marked this pull request as ready for review August 12, 2026 21:03
@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