Setup Module Federation with SSR for Angular and React
This guide will walk you through creating a Module Federated setup with Server Side Rendering (SSR) for Angular and React using Nx and its generators.
Create an empty workspace
Run the following command with the options listed to create an empty workspace.
✔ Choose your style · integrated ✔ What to create in the new workspace · apps ✔ Repository name · myorg ✔ Enable distributed caching to make your CI faster · No
You will also be prompted whether to add Nx Cloud to your workspace. We won't address this in this recipe, but you can see the introduction to Nx Cloud for more details.
Install your framework plugin
npm install --save-dev @nrwl/angular
Generating a host and multiple remotes with SSR
We will generate the apps required for a storefront application.
We will need the following applications:
- Store - host application
- Product - remote application
- Checkout - remote application
Nx allows you to do this with a single command:
npx nx g @nrwl/angular:host store --ssr --remotes=product,checkout
This will generate three applications, set up with SSR and Module Federation.
Serving the store application
When using Module Federation, we want to serve the host application along with the remote applications so that everything works as expected.
To do this, run:
npx nx serve-ssr store
This will run all three application servers but only the
store will be watching for file changes. If you make a change to one of the remote applications (
product) the changes will not be hot reloaded.
Serving the store application with file watching for checkout
If working on a remote application, we can still serve it via the host application and have it watch for changes.
To serve the
store application and watch for changes on the
checkout application run:
npx nx serve-ssr store --devRemotes=checkout
To learn more about Module Federation, we have some resources you might find useful: