hypr.stream

Setup guide

Minimal beta checklist for Stripe Checkout donations, Stripe Connect onboarding, Convex-backed widgets, OBS overlays, and the chat relay with a 0% platform fee posture.

1. Runtime

  • Set Convex URL and Clerk keys for the panel.
  • Set CLERK_JWT_ISSUER_DOMAIN in the Convex dashboard.
  • Run Convex codegen after the issuer is configured.

2. Payments

  • Set STRIPE_SECRET_KEY and STRIPE_WEBHOOK_SECRET in Convex.
  • Complete Stripe Connect onboarding from the panel and confirm payout readiness.
  • For MVP-1 beta, keep platform fee at 0% (Stripe processing fees still apply).
  • Treat refunds and disputes as streamer-owned, with platform support escalation when needed.
  • Use Stripe test mode before live donations.

3. OBS

  • Create or reuse default widgets in the panel.
  • Issue an overlay token for each browser source.
  • Use the panel preview and test event before copying the URL to OBS.

4. Chat relay

  • Deploy the relay with CHAT_RELAY_INTERNAL_SECRET set.
  • Point NEXT_PUBLIC_CHAT_RELAY_URL, VITE_CHAT_RELAY_URL, and VITE_OVERLAY_FANOUT_URL to the hosted relay.
  • Expose /health for panel reachability checks.
  • Publish chat messages only through the internal bearer-auth endpoint.

5. Verification

  • Run pnpm check:runtime-config, check:vercel-env-shape, and check:deployed-auth-config.
  • Run pnpm check:convex-http-smoke, check:public-web-smoke, and check:local-drills.
  • Treat pnpm check:backlog-completion as the final gate before beta.