Vouch Referral Widget

An embeddable widget for staking PLS with a referral code on PulseChain. Styled with the Vouch app design language (light & dark themes) and always carries Vouch branding.

Pages

Page	URL	Purpose
Widget	/ (index.html)	The embeddable staking widget
Configurator	/config.html	Customize + generate embed snippet with live preview

Usage

Direct URL

https://refwidget.vouch.run/?ref=3

iframe Embed

<iframe
  src="https://refwidget.vouch.run/?ref=3"
  width="420"
  height="640"
  style="border: 0; border-radius: 30px;"
  allow="clipboard-write"
></iframe>

See docs/EMBED.md for full documentation.

Development

npm install
npm run dev        # widget at /, configurator at /config.html

Open test-embed.html in a browser to see multiple embed variants side by side.

Build

npm run build      # outputs dist/index.html + dist/config.html

Test

npm test

Stack

• Vite + React + TypeScript
• wagmi + viem
• Reown AppKit (WalletConnect)
• @vouchrun/referral-sdk