> ## 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. # Examples > Choose the right SolvaPay SDK example project and run it locally. ## Quick comparison | Example | Framework | Checkout type | Auth | Best for | | ---------------------------------------------------------------------------------------------------------------- | ----------------------- | ----------------------------------- | --------------------------------- | -------------------------------------------------- | | [express-basic](https://github.com/solvapay/solvapay-sdk/tree/main/examples/express-basic) | Express.js | Paywall only | Header-based | First integration and API protection | | [express-provider-linkage](https://github.com/solvapay/solvapay-sdk/tree/main/examples/express-provider-linkage) | Express.js | Paywall only | Provider-owned (`ensureCustomer`) | BYO CLI/IdP linkage from your backend | | [nextjs-auth0](https://github.com/solvapay/solvapay-sdk/tree/main/examples/nextjs-auth0) | Next.js | Embedded | Auth0 | Auth0 web reference for `externalRef` linkage | | [checkout-demo](https://github.com/solvapay/solvapay-sdk/tree/main/examples/checkout-demo) | Next.js | Embedded | Supabase | Full custom checkout flow | | [hosted-checkout-demo](https://github.com/solvapay/solvapay-sdk/tree/main/examples/hosted-checkout-demo) | Next.js | Hosted | Supabase | Fast checkout integration | | [shadcn-checkout](https://github.com/solvapay/solvapay-sdk/tree/main/examples/shadcn-checkout) | Vite + shadcn/ui | Embedded | Supabase | Paste-in Lovable / shadcn projects | | [tailwind-checkout](https://github.com/solvapay/solvapay-sdk/tree/main/examples/tailwind-checkout) | Vite + Tailwind | Embedded | Supabase | Plain Tailwind checkout | | [supabase-edge](https://github.com/solvapay/solvapay-sdk/tree/main/examples/supabase-edge) | Supabase Edge Functions | Embedded + webhooks | Supabase | Fetch-native backend with `@solvapay/server/fetch` | | [mcp-time-app](https://github.com/solvapay/solvapay-sdk/tree/main/examples/mcp-time-app) | MCP App | Paywall only | OAuth + Bearer | Smallest UI-enabled MCP app | | [mcp-oauth-bridge](https://github.com/solvapay/solvapay-sdk/tree/main/examples/mcp-oauth-bridge) | MCP Server | Paywall only | OAuth + Bearer | Non-hosted MCP OAuth bridge | | [mcp-checkout-app](https://github.com/solvapay/solvapay-sdk/tree/main/examples/mcp-checkout-app) | MCP App + Node server | Hybrid (embedded + hosted fallback) | OAuth + Bearer | Complete self-serve MCP product | | [cloudflare-workers-mcp](https://github.com/solvapay/solvapay-sdk/tree/main/examples/cloudflare-workers-mcp) | Cloudflare Workers | Paywall + UI widget | OAuth + Bearer | Edge-deployed MCP server | | [supabase-edge-mcp](https://github.com/solvapay/solvapay-sdk/tree/main/examples/supabase-edge-mcp) | Supabase Edge Functions | Paywall + UI widget | OAuth + Bearer | MCP server at the network edge | | [supabase-edge-mcp-proxy](https://github.com/solvapay/solvapay-sdk/tree/main/examples/supabase-edge-mcp-proxy) | Cloudflare Worker proxy | Routing only | n/a | Custom domain in front of Supabase Edge MCP | ## Prerequisites * Node.js 20+ * pnpm * SolvaPay account (for real-backend examples) * Supabase project (for Supabase examples) From workspace root: ```bash theme={null} pnpm install pnpm build:packages ``` ## Run any example ```bash theme={null} cd examples/ cp env.example .env.local pnpm dev ``` Use `.env` instead of `.env.local` when the example README says so. ## Example notes ### express-basic * Good first project for `payable.http()` * Uses stub mode and header-based customer identity * README: [examples/express-basic/README.md](https://github.com/solvapay/solvapay-sdk/tree/main/examples/express-basic/README.md) ### express-provider-linkage * Provider-owned client + IdP: backend calls `ensureCustomer(externalRef)` before metering * Simulates post-CLI-login requests with `x-provider-user-id` * README: [examples/express-provider-linkage/README.md](https://github.com/solvapay/solvapay-sdk/tree/main/examples/express-provider-linkage/README.md) ### nextjs-auth0 * Auth0 Regular Web App + embedded Pay As You Go checkout * Canonical web reference for Auth0 `sub` → SolvaPay customer linkage * README: [examples/nextjs-auth0/README.md](https://github.com/solvapay/solvapay-sdk/tree/main/examples/nextjs-auth0/README.md) ### checkout-demo * Embedded checkout with React components * Uses Supabase auth and purchase gating * README: [examples/checkout-demo/README.md](https://github.com/solvapay/solvapay-sdk/tree/main/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](https://github.com/solvapay/solvapay-sdk/tree/main/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](https://github.com/solvapay/solvapay-sdk/tree/main/examples/supabase-edge/README.md) ### mcp-time-app * MCP app UI resource + protected tools * Demonstrates `createSolvaPayMcpServer` and `registerPayable` with OAuth context * README: [examples/mcp-time-app/README.md](https://github.com/solvapay/solvapay-sdk/tree/main/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](https://github.com/solvapay/solvapay-sdk/tree/main/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 `` 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](https://github.com/solvapay/solvapay-sdk/tree/main/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](https://github.com/solvapay/solvapay-sdk/tree/main/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](https://github.com/solvapay/solvapay-sdk/tree/main/examples/supabase-edge-mcp/README.md) ### supabase-edge-mcp-proxy * Cloudflare Worker that remaps `https://your-subdomain/*` → `https://.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](https://github.com/solvapay/solvapay-sdk/tree/main/examples/supabase-edge-mcp-proxy/README.md) ## Next steps * [Quick start](../setup/quick-start) * [MCP guide](./mcp) * [Next.js guide](./nextjs) * [React guide](./react)