Architecture

Korporus combines Module Federation, manifest validation, and Web Components into a runtime composition platform.

Host and remote model

The shell is the host; app packages are remotes.

Runtime bootstrap loading

The host resolves an app manifest, registers the remote entry with Module Federation runtime, and imports the remote bootstrap module.

Bootstrap registers custom elements for titlebar, main, and settings views.

Manifest and schema

Validation protects the runtime boundary.

Strict manifest contract

Every app advertises metadata, remote entry URL, and slot tag names through a JSON manifest.

The schema package ensures malformed manifests fail before any runtime import occurs.

Slot mounting

Host surfaces remain consistent while app internals stay isolated.

Titlebar/Main/Settings

The shell layout reserves three regions. Remotes provide custom elements for any subset of those slots.

Shared app state

Because slot components run in one remote runtime context, app state can synchronize naturally across mounted views.

Deployment topology

Static hosts and remote runtime infrastructure are decoupled.

App Runner runtime

The containerized shell and remote assets run on App Runner with scale-to-zero support.

Amplify host apps

React and Angular demo hosts deploy independently to Amplify Gen2 while consuming the same runtime remote contract.