Examples

Documentation Index

Fetch the complete documentation index at: https://docs.solvapay.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Quick comparison

​

Prerequisites

• Node.js 20+
• pnpm
• SolvaPay account (for real-backend examples)
• Supabase project (for Supabase examples)

pnpm install
pnpm build:packages

​

Run any example

cd examples/<example-name>
cp env.example .env.local
pnpm dev

​

Example notes

​

express-basic

• Good first project for payable.http()
• Uses stub mode and header-based customer identity
• README: examples/express-basic/README.md

​

checkout-demo

• Embedded checkout with React components
• Uses Supabase auth and purchase gating
• README: examples/checkout-demo/README.md

​

hosted-checkout-demo

• Hosted checkout and hosted customer portal
• Lower PCI complexity than embedded checkout
• README: examples/hosted-checkout-demo/README.md

​

supabase-edge

• Fetch-native backend for Supabase Edge Functions using @solvapay/server/fetch
• One two-line file per handler; solvapayWebhook factory for webhooks
• README: examples/supabase-edge/README.md

​

mcp-time-app

• MCP app UI resource + protected tools
• Demonstrates payable.mcp() with OAuth context
• README: examples/mcp-time-app/README.md

​

mcp-oauth-bridge

• Local discovery metadata for non-hosted MCP origin
• OAuth + dynamic client registration bridge pattern
• README: examples/mcp-oauth-bridge/README.md

​

mcp-checkout-app

• Full 5-intent MCP App (plans, checkout, top-up, usage, paywall)
• Hybrid checkout: embedded Stripe Elements via <PaymentForm> on compliant hosts (basic-host, ChatGPT); auto-falls back to hosted SolvaPay checkout on hosts that ignore _meta.ui.csp (Claude)
• Ships with createMcpAppAdapter wired to SolvaPayProvider and a paywalled demo toolbox
• README: examples/mcp-checkout-app/README.md

​

cloudflare-workers-mcp

• Single fetch handler built with createSolvaPayMcpFetch from @solvapay/mcp/fetch — OAuth discovery, bridge routes, tool calls, and the widget iframe in one worker
• Ships a seeded stock-predictor demo toolbox (predict_price_chart, predict_direction) to exercise the paywall end-to-end
• README: examples/cloudflare-workers-mcp/README.md

​

supabase-edge-mcp

• Same toolbox as cloudflare-workers-mcp, deployed as a single Supabase Edge Function
• Uses Deno.serve(createSolvaPayMcpFetch(…)) from @solvapay/mcp/fetch
• Pair with supabase-edge-mcp-proxy if you need a custom domain in front of Supabase’s /functions/v1/… URL shape (required for RFC 9728 .well-known/oauth-protected-resource discovery)
• README: examples/supabase-edge-mcp/README.md

​

supabase-edge-mcp-proxy

• Cloudflare Worker that remaps https://your-subdomain/* → https://<proj>.supabase.co/functions/v1/mcp/*
• Fixes OAuth Protected Resource Metadata discovery for MCP Inspector and ChatGPT connectors
• README: examples/supabase-edge-mcp-proxy/README.md

​

Next steps

• Quick start
• MCP guide
• Next.js guide
• React guide