Codestin Search App

tonoizer · 2026-06-10T09:11:34Z

Summary

SSR hosts can use entry: "…/mf-manifest.json" interchangeably with remoteEntry.js. On the server, ssrEntryLoader reads metaData.ssrRemoteEntry from the manifest and loads the Node SSR entry. This unlocks Module Federation Chrome DevTools manifest-based discovery.

Scope (intentionally narrow):

ssrEntryLoader — manifest-first SSR resolution for .json entries; HEAD-check ssrRemoteEntry; fallback to __mf_server__ / URL convention; existing remoteEntry.js path unchanged
index.ts — configEnvironment sets ENV_TARGET: "node" on server/ssr Vite environments only (client stays "web")

Out of scope: no changes to virtual remote wrappers, shared prebuild codegen, or client-side manifest handling (handled by @module-federation/enhanced runtime).

Usage

Remote (manifest: true required):

federation({ name: "remote", filename: "remoteEntry.js", manifest: true, exposes: { … } });

Host (either entry style):

remotes: {
  remote: {
    type: "module",
    name: "remote",
    entry: "http://localhost:4174/mf-manifest.json", // or …/remoteEntry.js
  },
},

Test plan

pnpm test (ssrEntryLoader manifest-as-entry + ENV_TARGET configEnvironment tests)
pnpm playwright test --project=multi-example (10/10)

Enable manifest-first SSR entry resolution, ENV_TARGET node for Environment API server builds, and synchronous remote/shared exports on first server render so hosts can use mf-manifest.json interchangeably with remoteEntry.js. Co-authored-by: Cursor <[email protected]>

chatgpt-codex-connector · 2026-06-10T09:11:39Z

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

tonoizer · 2026-06-10T09:13:26Z

I can also adjust the vite examples PR (gioboa/module-federation-vite-examples#6) to use the manifest instead of the remoteEntry.js as a demo.

gioboa

Thanks for your help

pkg-pr-new · 2026-06-10T09:57:17Z

Open in StackBlitz

npm i https://pkg.pr.new/@module-federation/vite@798

commit: 25249c4

Co-authored-by: Cursor <[email protected]>

Vite 5/6 may invoke config() without a bound `this`, so read SSR target only from config.build.ssr there. Environment API ssr/server targets stay in configEnvironment, with the unit test updated accordingly. Co-authored-by: Cursor <[email protected]>

Use lazy client initPromise in browser builds while SSR bundles await the local fallback, so singleton shared libs initialize once in preview and named workspace exports stay defined on the server. Co-authored-by: Cursor <[email protected]>

Use existing __mfRemotePending.then chains instead of await in generated remote modules so unified/client wrappers stay synchronous for Nuxt and other frameworks. Workspace singleton shares keep initPromise.then lazy fallbacks in build output without import.meta.env.SSR await branches. Co-authored-by: Cursor <[email protected]>

configEnvironment was mutating a shared define object, so the ssr env's node target leaked into the client graph and pulled Node builtins into the browser. Copy define per environment so client stays web and ssr stays node. Co-authored-by: Cursor <[email protected]>

Revert virtualRemoteEntry, virtualShared_preBuild, and their tests to main. Remove the merged react-redux optimizeDeps test from index.test.ts so the branch diff stays focused on manifest-as-entry SSR support. Co-authored-by: Cursor <[email protected]>

configEnvironment now returns early for client environments so ENV_TARGET stays web in the browser graph. SSR entry resolution is cached per remote entry URL so mixed remoteEntry.js and mf-manifest.json hosts resolve correctly. Co-authored-by: Cursor <[email protected]>

…names

Use sync local share imports during SSR builds while keeping lazy initPromise on the client so workspace singletons initialize once in preview without breaking named exports on the server. Co-authored-by: Cursor <[email protected]>

…nner Fall through to the HTTP temp-file loader when ModuleRunner is unavailable or returns an invalid module, and probe /__mf_ssr__/ and /__mf_server__ when a pre-resolved .ssr.js URL from the manifest is unreachable. Co-authored-by: Cursor <[email protected]>

…de effects

gioboa

Tests With Different Frameworks

…lled

gioboa

I did a check with LLM and there are few things to fix.
Findings:

src/index.ts:627 removes LOAD_SHARE_TAG / PREBUILD_TAG from parse-end exclusion. That reverts the recent “reduce latency” behavior and
makes generated shared modules gate parsePromise again. Risk: large builds wait/timeout on MF-generated virtual modules unrelated to app
parse completion.
src/utils/ssrEntryLoader.ts:550 now falls through from /mf_ssr/ ModuleRunner failure/unavailable into fetchEsmToTempFile. For dev SSR
this path is known broken: served SSR entry imports virtual:mf-exposes-ssr:*, and temp-file import can’t resolve Vite virtual ids. This
silently masks runner failures and does wasted/brittle fetch/import work.
src/index.ts:1105 configEnvironment overwrites existing env-level define.ENV_TARGET. Root config() deliberately preserves user-defined
ENV_TARGET; this hook should likely do same or warn.

…port

Resolved conflict in virtualShared_preBuild.test.ts by preserving the SSR-specific assertions (if (import.meta.env.SSR) guard and await import) from the PR while incorporating the initPromise.then assertion from upstream. Dropped upstream's not.toContain('await ') assertion which is incompatible with the SSR branch that intentionally uses await. Co-Authored-By: Claude Sonnet 4.6 <[email protected]>

…onous local fallback

gioboa

Thanks @tonoizer
I manually tested it with the Nuxt example and SSR manifest is working fine.

gioboa

Tests With Different Frameworks

gioboa reviewed Jun 10, 2026

View reviewed changes

Comment thread MANIFEST_SSR.md Outdated

gioboa changed the title ~~feat(ssr): support mf-manifest.json as remote entry URL~~ feat(ssr): support mf-manifest.json as remote entry URL Jun 10, 2026

tonoizer and others added 3 commits June 10, 2026 20:55

chore: remove MANIFEST_SSR.md PR draft doc

f0cf87c

Co-authored-by: Cursor <[email protected]>

tonoizer requested a review from gioboa June 10, 2026 19:53

tonoizer and others added 12 commits June 11, 2026 08:29

Merge branch 'main' into feat/ssr-manifest-support

a70d570

feat: enhance SSR entry resolution with manifest fetch caching

e45a1c6

refactor: update manifest entry detection to support custom JSON file…

5d600fd

…names

Merge branch 'main' into feat/ssr-manifest-support

16c3c04

chore: run format 🍉

48f3930

fix: use dynamic import for SSR in build mode to prevent duplicate si…

22df0f9

…de effects

gioboa reviewed Jun 12, 2026

View reviewed changes

Comment thread src/index.ts

Merge branch 'main' into feat/ssr-manifest-support

4be9055

gioboa reviewed Jun 12, 2026

View reviewed changes

fix: exclude shared react from optimizeDeps when react-redux is insta…

37ad06f

…lled

gioboa reviewed Jun 13, 2026

View reviewed changes

gioboa requested changes Jun 13, 2026

View reviewed changes

feat: enhance module federation with prebuild and load-share tags sup…

b990f9d

…port

tonoizer requested a review from gioboa June 13, 2026 14:23

gioboa reviewed Jun 13, 2026

View reviewed changes

Comment thread src/virtualModules/virtualRemoteEntry.ts Outdated

Merge branch 'main' into feat/ssr-manifest-support

b8b0719

gioboa reviewed Jun 13, 2026

View reviewed changes

Comment thread src/virtualModules/virtualShared_preBuild.ts

fix: support SSR manifest remotes

d256f4d

tonoizer requested a review from gioboa June 14, 2026 15:44

gioboa reviewed Jun 15, 2026

View reviewed changes

Comment thread src/virtualModules/virtualShared_preBuild.ts Outdated

refactor: update SSR handling in virtualShared_preBuild to use synchr…

e5d0243

…onous local fallback

gioboa reviewed Jun 15, 2026

View reviewed changes

Comment thread src/virtualModules/virtualShared_preBuild.ts

feat: prepend workspace singleton SSR import for improved SSR handling

9e14fa7

tonoizer requested a review from gioboa June 15, 2026 21:14

gioboa and others added 4 commits June 16, 2026 14:14

Merge branch 'main' into feat/ssr-manifest-support

0489e1e

Merge branch 'main' into feat/ssr-manifest-support

0083bd1

fix: support manifest SSR entry loading

1be192d

fix: minor updates

25249c4

gioboa approved these changes Jun 16, 2026

View reviewed changes

gioboa reviewed Jun 16, 2026

View reviewed changes

gioboa merged commit e173aba into module-federation:main Jun 16, 2026
19 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(ssr): support mf-manifest.json as remote entry URL#798

feat(ssr): support mf-manifest.json as remote entry URL#798
gioboa merged 28 commits into
module-federation:mainfrom
tonoizer:feat/ssr-manifest-support

tonoizer commented Jun 10, 2026 •

edited

Loading

Uh oh!

chatgpt-codex-connector Bot commented Jun 10, 2026

Uh oh!

tonoizer commented Jun 10, 2026

Uh oh!

gioboa left a comment

Uh oh!

Uh oh!

pkg-pr-new Bot commented Jun 10, 2026 •

edited

Loading

Uh oh!

Uh oh!

gioboa left a comment

Uh oh!

gioboa left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

gioboa left a comment

Uh oh!

gioboa left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

tonoizer commented Jun 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Usage

Test plan

Uh oh!

chatgpt-codex-connector Bot commented Jun 10, 2026

Uh oh!

tonoizer commented Jun 10, 2026

Uh oh!

gioboa left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

pkg-pr-new Bot commented Jun 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

gioboa left a comment

Choose a reason for hiding this comment

Tests With Different Frameworks

Uh oh!

gioboa left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

gioboa left a comment

Choose a reason for hiding this comment

Uh oh!

gioboa left a comment

Choose a reason for hiding this comment

Tests With Different Frameworks

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

tonoizer commented Jun 10, 2026 •

edited

Loading

pkg-pr-new Bot commented Jun 10, 2026 •

edited

Loading