vite-plugin-federationProduction Module Federation for Vite

Manifest-first remotes, SSR-aware loading, runtime rollout controls, and migration paths for modern Vite applications.

Manifest-first loading

Remotes emit mf-manifest.json, mf-stats.json, and mf-debug.json so hosts can load, validate, debug, and roll back releases with explicit metadata.

Production host controls

The curated runtime adds cache TTL, stale-while-revalidate, retries, fallback URLs, timeouts, circuit breakers, request collapsing, and telemetry hooks.

SSR and preload helpers

Node hosts can select SSR entries, create server federation instances, and collect preload links for streamed HTML.

Dev remote HMR

Opt-in remote HMR classifies updates as partial, style, types, or full reload so local federation workflows stay fast.

Migration compatibility

OriginJS virtual APIs and common Module Federation Vite options are supported while teams move toward manifest-first runtime APIs.

Stable public contract

v1 documents plugin options, runtime exports, manifest schema, devtools events, and MFV error-code meanings.

Federation Flow

BuildGenerate remote entries, manifest artifacts, type bundles, and debug metadata.PublishServe manifests with short cache policy and immutable entries/assets behind a stable URL.RegisterFetch, validate, cache, and register remotes through the curated runtime entry.OperateObserve remote loads, refresh manifests, isolate tenants, and roll back by manifest.

import { loadRemoteFromManifest } from 'vite-plugin-federation/runtime';

const catalog = await loadRemoteFromManifest(
  'catalog/Button',
  'https://cdn.example.com/catalog/mf-manifest.json',
  {
    cacheTtl: 30_000,
    integrity: true,
    retries: 2,
    timeout: 4_000,
  },
);

Where To Start

New host or remote

Start with the quick guide, then use the plugin and runtime references for the full option surface.

Production rollout

Use the manifest, runtime, security, preload, and troubleshooting guides before publishing remote artifacts.

Migration

Use the comparison and migration guides when moving from OriginJS or the official Module Federation Vite adapter.

Documentation Map

Getting Started gives a minimal remote, host, and runtime load path.
Plugin API, Runtime API, and Public API Contract define the stable v1 surface.
Manifest Protocol, Production Runtime, Preload And Performance, Multi-Tenant Isolation, and Security cover rollout behavior.
Dev Remote HMR, DTS Workflows, DevTools Contract, and Compiler Adapter cover local development and build internals.
Plugin Comparison, From @module-federation/vite, and From OriginJS cover adoption choices.
Reference, Examples, Schemas, llms.txt, and llms-full.txt are generated from the current repository.