Module Federation#

Module Federation is an architectural pattern for JavaScript application decomposition (similar to microservices on the server-side), allowing you to share code and resources between multiple JavaScript applications (or micro-frontends).

The Rspack team works closely with the Module Federation development team and provides first-class support for Module Federation.

Use Cases#

Module Federation has several typical use cases, including:

• Allowing independent applications (called "micro-frontends" in micro-frontend architecture) to share modules without recompiling the entire application.
• Different teams working on different parts of the same application without needing to recompile the entire application.
• Dynamic code loading and sharing between applications at runtime.

Module Federation can help you:

• Reduce code duplication
• Improve code maintainability
• Reduce the overall size of applications
• Improve application performance

How to Use#

Module Federation (MF) currently has multiple major versions, and you can choose one based on your needs.

Here are the characteristics of several versions:

Module Federation v2.0#

Module Federation 2.0 provides some additional out-of-the-box features based on Module Federation, such as dynamic TS type hints, Chrome devtools, Runtime plugins, preloading, making Module Federation more suitable for micro-frontend architecture supporting large-scale Web applications. Module Federation v2.0 is implemented based on v1.5.

You need to install the additional @module-federation/enhanced plugin to use Module Federation v2.0.

const {
  ModuleFederationPlugin,
} = require('@module-federation/enhanced/rspack');

module.exports = {
  plugins: [
    new ModuleFederationPlugin({
      // options
    }),
  ],
};

Please refer to the Module Federation v2.0 official documentation for specific usage details.

Module Federation v1.5#

This is the version built into Rspack. In addition to supporting Module Federation v1.0's capabilities such as module export, module loading, and dependency sharing, it also adds runtime plugin functionality, allowing users to extend the behavior and functionality of module federation.

You can use it through Rspack's ModuleFederationPlugin without installing any additional plugins.

const rspack = require('@rspack/core');

module.exports = {
  output: {
    // set uniqueName explicitly to make HMR works
    uniqueName: 'app',
  },
  plugins: [
    new rspack.container.ModuleFederationPlugin({
      // options
    }),
  ],
};

Reference: Module Federation v1.5 example.

Module Federation v1.0#

This version is implemented for compatibility with webpack.container.ModuleFederationPlugin.

You can use it through Rspack's ModuleFederationPluginV1.