GiveReady Donate Widget Demo

Widget Features

Zero Dependencies

Self-contained, no frameworks or external libraries. Single 15KB JavaScript file.

Live Data

Fetches nonprofit data and wallet address from GiveReady API in real-time.

Solana Pay QR

Generates Solana Pay QR codes dynamically for any donation amount.

Mobile Optimized

Deep links to Phantom and Coinbase Wallet for seamless mobile donations.

No Intermediary

Direct USDC transfers. No platform fees. Nonprofit keeps 100%.

Fully Branded

Clean, modern UI that matches any website. Inline CSS, no stylesheets.

Live Demo

Finn Wardman World Explorer Fund

The widget below is a live example. Click the button to see the donation modal, select an amount, and scan the Solana Pay QR code with Phantom or Coinbase Wallet.

How to Embed

Add this HTML snippet to your website to enable USDC donations:

<div id="giveready-donate"
     data-slug="your-nonprofit-slug">
</div>
<script src="https://giveready.org/widget/donate.js"></script>
        

Replace your-nonprofit-slug with your organization's GiveReady slug. Find your slug →

Technical Specifications

File Size: ~15KB (minified, gzipped: ~5KB)
Browser Support: All modern browsers (ES6+), mobile optimized
API Base: https://giveready.org/api
QR Code Generator: QR Server API (free, no auth required)
Solana Network: Mainnet Beta (USDC: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v)
Supported Wallets: Phantom Wallet, Coinbase Wallet, any Solana Pay compatible wallet
Data Fetched: Nonprofit name, mission, USDC wallet address
Permissions Required: None (read-only API calls)
CSS Injection: Single <style> tag inserted once per page load
Modal Scope: All CSS classes prefixed with giveready- to prevent conflicts

Testing the Widget

To test the donation flow:

Click "Donate with USDC" button above
Select an amount ($1, $5, $10, $25, or custom)
Scan the QR code with Phantom or Coinbase Wallet
Or click "Phantom Wallet" or "Coinbase Wallet" on mobile
Sign the transaction in your wallet
Donation settles on Solana blockchain

Open Source

The GiveReady widget is open-source and available on GitHub.

Licensed under MIT. Fork, customize, and deploy on your own infrastructure.

git clone https://github.com/giveready/widget.git
cd widget
npm install
npm run build
        