Glossary

Shell Component

A shell component is any constant extending WebshellComponent, e.g. any constant returned by makeWebshell.

A shell equals an instance of a WebshellComponent:

Native

<Webshell {...props} />

A controlling component is the component passing props to a shell:

Native

function ControllingComponent(props) {
  return <Webshell {...props} />
}

The native environment is the execution environment for React Native.

The Web environment is the execution environment for any code run in a WebView.

A Web feature, or simply feature, is a single-responsibility plugin which can be injected in a shell to add new behaviors.

A Web script is the source code associated with a Web feature run in the Web environment.

A shell handler is a function prop passed to a shell for reacting to messages sent from Web scripts.

Native

function shellHandler(message) {
  // do stuff with message
}
<Webshell onDOMFoo={shellHandler} />

A Web handler is a function run in Web scripts to react from messages sent from a controlling component.

Web

context.onShellMessage('eventId', function(message) {
  // do stuff with message
})