Examples

​

Quick comparison

​

Prerequisites

• Node.js 18+
• 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

​

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

​

Next steps

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