TouchwavesLLC
Sign in
DOCUMENTATION

Ship in four commands.

Touchwaves is yours to self-host. Clone the source, set your secrets, and deploy to Cloudflare or Vercel.

Quickstart

01Accept your GitHub invite

After purchase, enter your GitHub username on the delivery page. We add you as a collaborator on the private source repo.

$ git clone git@github.com:touchwaves/touchwaves.git
02Configure environment

Copy the example vars and drop in your database, auth secret, and Stripe keys. Dual-driver: D1 (Cloudflare) or Postgres (Vercel).

$ cp .dev.vars.example .dev.vars
03Migrate & seed

Generate and apply the schema for your driver, then seed the demo catalog so the storefront renders immediately.

$ pnpm db:migrate && pnpm db:seed
04Deploy

One command to ship to Cloudflare Workers, or use the Vercel target. Your license key activates the build.

$ pnpm deploy:cloudflare

Guides

Architecture

TanStack Start single app, feature-boundaried under src/features/*. Server functions carry the /api surface and the raw-body Stripe webhook.

Auth & roles

Better Auth with email + Google/GitHub. Admin role-gated route group; customer portal auth-gated. Request-context getAuth factory.

Payments

Stripe Checkout with idempotent provider_events. Refund-driven entitlement revocation. Edge-safe with Web Crypto webhook verification.

License & API keys

Hashed at rest (sha256), rotation + revocation, per-key access logs and rate limits in the Pro edition.

File delivery

R2 / S3 adapter with short-lived signed URLs and download logs. Versioned releases for subscribers.

Agent / MCP

Agent-readable metadata, customer-scoped data API, generated MCP endpoint, and tool-call logs in the Agent edition.

Ready to own your fulfillment stack?

One-time license. Full source. No platform lock-in.