Swap/Bridge Widget (iframe)

Embed the Router swap experience in your site by loading the hosted app inside an <iframe>. Configuration uses a JSON object (Widget Playground shape), usually passed as a config query parameter: encodeURIComponent(JSON.stringify(embedConfig)).

React / npm integration

For React apps, integrate using @routerprotocol/xplore-widget and BlinqWidget. See Swap/Bridge Widget (npm).

Key points

• Hosted UI — no npm package required; works with static HTML, WordPress, and any framework that can render an iframe.
• JSON config — theme, features, selectedNodes, initialState, integrator, and isWidget: true in one object on the swap URL.
• Playground parity — tune settings in the Widget Playground, then copy the same structure into your embed code.

Quick navigation

• Getting Started — minimal iframe + config= URL
• Configuration — full JSON reference and example
• Examples — build src in JavaScript, responsive wrapper
• Customization — iframe sizing and outer container CSS

Next steps

• Follow Getting Started
• Use the Widget Playground to validate JSON before shipping