Riftix Console Bridge
Shopify App Bridge–style messaging layer for embedded product iframes.
Riftix Console Bridge is a typed postMessage protocol that lets embedded product iframes control host chrome — toasts, modals, breadcrumbs, and navigation — without sharing origin or build context with the host.
It is the infrastructure layer of the Riftix Console: a multi-product shell where each product runs as a sandboxed iframe served from its own origin.
Packages
| Package | Role |
|---|---|
@riftix/console-bridge-types | Shared protocol types and constants — no runtime code. |
@riftix/console-bridge-host | Host-side transport. Registers iframes, dispatches RPCs, broadcasts context and authorization. |
@riftix/console-bridge-host/react | React provider and <ConsoleIframe> component. |
@riftix/console-bridge-snippet | IIFE bundle (riftix.js) loaded by the client page. Installs window.Riftix. |
@riftix/console-bridge-snippet-types | TypeScript types for window.Riftix — import as a side-effect for JSX and Window augmentations. |
@riftix/console-bridge-snippet-react | React hooks that read from window.Riftix. |
Quick navigation
- Getting Started — end-to-end setup in five minutes.
- Architecture — message flow, security model, and design decisions.
- Protocol Reference — every envelope, RPC method, and event.
- Snippet (client) —
window.RiftixAPI, web components, React hooks. - Host —
ConsoleHost,IframeChannel, React provider. - Design — how a console app should look: tokens, layout, components, and the chrome an app must delegate to the host.
- Development — monorepo workflow, ports, turbo tasks.