TL blog

MicroFrontend example with single react instance

September 05, 2020

Note: This application uses React 16, which makes the app can only use the same version of React as in Duplication React Issue. In React 17, it allows multiple React instances in the same app, if you are interested in that direction, can check out the sample at React upgrade demo.


This is basic structure for micro frontend app using React, Redux and React Router. The app contains single React instance for different modules. There are other ways to have micro frontend app such as creat multiple React roots. But for single page application with React, Redux, it will be difficult to share state between modules. This sample project focuses on create only single React root, so then modules can interact with other components as if they are in same bundled app.


The structure of the application as follow:


App structure

Main app contains common information and layout. After render, it will load the module base on static url address. Inside the module has a main entry which has list of routes, its components and root reducer of the module. All components are lazy loaded from the entry. Module can access and update its own store and the store that are defined in common.

Project setup

a. Main app

Compose of root component in React router

const renderApp = () => {
            <Provider store={store}>
                    <Router history={browserHistory}>
                        <Routes />

It also export function to dynamically replace redux reducer for main app.

export const updateStoreReducer = (storeReducer) => {
  const newReducers = combineReducers<ApplicationState>({
    core: coreReducer,

In Routes component, it renders the layout of main application, then lazy load other routes

declare global {
  interface Window { __MyModule: { default: DynamicModule } }

interface State {
  routes: DynamicRoute[];

class Routes extends React.PureComponent<Props, State> {
    this.state = {
      routes: []
  componentDidMount() {
    const dynamicModuleUrl = 'http://localhost:9000/myModule.js';
    import(/* webpackIgnore: true */ dynamicModuleUrl).then(_ => {
      this.setState({routes: window.__MyModule.default.getRoutes()})
      updateStoreReducer({ module: window.__MyModule.default.reducer });
  render() {
    return (
        <Switch location={this.props.history.location}>
          <Route path='/' component={Home} exact={true} />
          <Route path='/about' component={About} exact={true} />
          { => <Route key={r.path} path={r.path} component={r.component} exact={true} />)}
          <Redirect to='/' />

export default withRouter(Routes);

In order to plug the module into main application, the module has to export the routes, their components and the module’s root reducer.

b. Module

The entry point of the module has the structure as

const LazyMainComponent = React.lazy(() =>  import('./Main'));

const module: DynamicModule = {
    getRoutes: () => [
        { path: '/myModule', component: getLazyComponent(LazyMainComponent) }
    reducer: reducer,

export default module;

It exports all the routes that contains the lazy loaded components and a reducer. The entry has these lazy components to ensure that main app doesn’t need to load all the unnecessary javascript files on the first landing. Instead, every components in module will be loaded only when in need.

Module’ components can access to common and other’s module store as much as you want. But to increase the indepence between modules, it’s recommended that module components only access to common store and its own store.

If you need to access shared models between modules, it’d better to have these shared models as input data of modules.

c. Webpack

In main app

entry: {
    app: "./src/index.tsx",
externals: {
    react: 'React'

In module

output: {
    pathinfo: false,
    path: path.resolve(__dirname, "./dist"),
    filename: "[name].js",
    publicPath: "http://localhost:9000/",
    library: '__MyModule',
    libraryTarget: 'umd'
entry: {
    myModule: './index.tsx',
externals: {
    react: 'React'

Both main app and module’s webpack expect that React will be an external dependency. In order to include React in app, the temporal solution is to put it inside <head> document as in this example.

Full source code on Github

Written by Thang Le, who likes to learn new things.