Installation

io.Connect provides separate packages for different environments. Choose the packages that match your deployment target.

Browser Platform (Host App)

The host app initializes the io.Connect environment and manages messaging between client apps. It requires the browser-platform package.

Terminal
npm install @interopio/browser-platform @interopio/react-hooks

Browser Client (Child Apps)

Individual apps that connect to the platform hub. These use the lighter browser client package.

Terminal
npm install @interopio/browser @interopio/react-hooks

Desktop

For apps running inside the io.Connect Desktop native container.

Terminal
npm install @interopio/desktop @interopio/react-hooks

Optional Packages

PackagePurpose
@interopio/workspaces-apiWorkspaces window management API
@interopio/fdc3FDC3 compliance layer
@interopio/home-ui-reactReact components for Browser Home App
@interopio/cliCLI tool for Desktop project scaffolding
Peer DependenciesAll io.Connect React packages require react and react-dom 18+. Ensure these are installed in your project.

Version Compatibility

Keep all @interopio/* packages on the same major version to avoid compatibility issues. Check npm for the latest versions.