entria / react-app-loader

Production ready library for handling Microfrontends

react-app-loader

Production ready library for handling Microfrontends.

Demo and Example

How to use

Create a config file for each external app:

$ touch AnyExternalApp.js

Then, wrap it with withAppLoader HOC:

// @flow

import withAppLoader from '@entria/react-app-loader';

const elementId = 'github';
const appUrl = 'https://github.com/';

const AppLoader = withAppLoader({ elementId, appUrl });

export default AppLoader;

Or you can try a more complex way, passing some props:

// @flow

import React from 'react';
import withAppLoader from '@entria/react-app-loader';

const elementId = 'github';
const appUrl = 'https://github.com/';

type Props = {
  externalUrl: string,
};

const AnyExternalApp = (props: Props) => {
  const { externalUrl } = props;
  const AppLoader = withAppLoader({
    elementId,
    appUrl: externalUrl != null && externalUrl.length > 0 ? externalUrl : appUrl
  });
  return <AppLoader />;
};

export default AnyExternalApp;

Import it on your React app:

import React, { Component } from 'react';
import logo from './logo.svg';
import './App.css';

import AnyExternalApp from './AnyExternalApp';

class App extends Component {
  render() {
    return (
      <div className="App">
        <AnyExternalApp />
      </div>
    );
  }
}

export default App;

Import babel-polyfill on your index.js

import 'babel-polyfill';

Run \o/

Handling cors during development

On Google Chrome, just install this extension: https://chrome.google.com/webstore/detail/allow-control-allow-origi/nlfbmbojpeacfghkpbjhddihlkkiljbi

License

MIT

react-app-loader's Issues

webpack instances conflicts

If you have different versions of webpack in your apps, it could run in some troubles

How to fix it

output: { 
   jsonpFunction: 'appJsonpFunction' 
}

fix flow errors

migrate to babel 7

migrate to ts

babel-polyfill conflicts

• babel-polyfill

If another app also adds babel-polyfill it will cause troubles

Uncaught Error: only one instance of babel-polyfill is allowed
    at Object.eval (VM14221 index.js:10)
    at eval (VM14221 index.js:29)
    at Object../node_modules/babel-polyfill/lib/index.js

How to improve script load performance

I was thinking about how to improve the performance of the scripts in my applications.

I currently have several applications using React.

My idea is the root application load the libraries together and the loaded application only provides the app script.

Is that a valid idea? Has anyone had success or failures at this point?

References

• https://medium.com/@tomsoderlund/micro-frontends-a-microservice-approach-to-front-end-web-development-f325ebdadc16
• https://medium.com/@_rchaves_/building-microfrontends-part-i-creating-small-apps-710d709b48b7

Improve README

Add more information and examples:

• Add a working example with React Router
• Add an example with LoadingComponent
• Add an example with shared authentication layer
• Add an example with shared style
• Add an example with more complex props and state
• More informaton about development setup (handling cors, etc)
• Relay?
• Redux?

fix gh pages demo cors

Failed to load https://github.com/: No 'Access-Control-Allow-Origin' header is present on the
 requested resource. Origin 'https://entria.github.io' is therefore not allowed access.

add tests