Loading subapps from a different repo

[divyakarippath]

Directory structure of individual subapps:

my-sub-app
├── README.md
├── package.json
├── src
........├── index.js
........├── subapp.js
........├── server.js
........├── reducers.js

Each subapp should be exporting the manifest and sub-app options as below

const subAppOptions = {
  serverSideRendering: false
};

const manifest = {
  type: "app",
  name: "Demo1",
  entry: require.resolve("./subapp"),
  serverEntry: require.resolve("./server"),
  reducers: require.resolve("./reducers")
};

module.exports = { subAppOptions, manifest `};

The users must provide absolute paths for entry, serverEntry and reducers
Publishing : The code must be transpiled to node executable format before publishing the package.

Main app:

Create a file named subapps-modules.js in src and export the manifests for all the subapp modules

const demo1 = require("demo1");
const demo2 = require("demo2");

module.exports = {
  demo1: demo1.manifest,
  demo2: demo2.manifest
};

Update the routes file to load the subapp module.

export default {
"/home": {
    pageTitle: "Welcome to home",
    subApps: ["demo1", "demo2"]
  }
}

Main app can also customize the options for subapp as below.

"/home": {
    pageTitle: "Welcome to home",
    subApps: [["demo1", subAppOptions], ["demo2", subAppOptions]]
  }
}

[jchip]

what's this trying to do?

[divyakarippath]

This is to handle the scenario where subapp name is just the module name (when loading from a separate repo)

"/demo1": {
    pageTitle: "Welcome to Demo1",
    subApps: [["demo1", demo1.subAppOptions]],
  },

For the sub-apps from a separate repo, its path is set as Path.dirname(require.resolve(`${modName}/package.json`)) in subAppsByPath. Same logic is used here to retrive the details from the map.

Another option I was considering it is to set module:true in subappOptions and use that flag instead of checking for / in url. But that would be one additional thing to be set by the main app.

In existing code, if path is not absolute, we assume it's relative to app src dir.

[divyakarippath]

Updated the code to remove module:true flag

[jchip]

error message is not very clear

[divyakarippath]

Updated the error message in latest commit

[divyakarippath]

Added this to support passing subapp options from main app also. This will be useful in use-cases where main app wants to customize the options for individual subapps.

[divyakarippath]

Changed to match the version with latest publish

[divyakarippath]

To fix the build issue