Skip to main content

Guides

How-to pages covering concerns that span more than one component or hook.

  • Error handling — how the SDK surfaces server errors, the isRiftApiError(err, "code") narrowing pattern, and the typed extensions every recoverable error carries.
  • Server-side rendering — what the SDK guarantees for Next.js App Router, Astro islands, and Vite SPAs, and what consumers need to do to hold those guarantees.
  • Securing the order-status token — how to carry the post-checkout JWT across Stripe's confirmPayment redirect without leaking it into history, the Referer header, or server logs.
  • Pricing and estimates — the wave-tier pricing model, the greedy-fill algorithm the picker uses, and the disclaimer the breakdown surfaces near the total.
  • Theming — CSS custom properties scoped to [data-rift-root], three override layers (plain CSS, the appearance prop, the dark token variant), and what the SDK deliberately does NOT paint on the wrapper.
  • Internationalization — locale negotiation, the per-key string override pattern, and the full key catalog.
  • Troubleshooting — common pitfalls (missing provider scope, forgotten captcha, Stripe peers, SSR imports) and what to do about each.

For per-symbol details (props, return shapes, error codes), see the API reference.