Skip to main content
The Next.js client package (@revstackhq/next/client) re-exports all React components and hooks from @revstackhq/react.Use these in Client Components (files with "use client" directive).

​
Exports

All exports are marked with the "use client" directive and safe to use in Next.js App Router Client Components.

​
Components

  • RevstackProvider - Context provider for the Revstack client

​
Hooks

  • useRevstack() - Returns the RevstackClient instance
  • useEntitlement(key) - Subscribes to entitlement changes

​
Client Class

  • RevstackClient - Low-level client (typically accessed via useRevstack())

​
Types

  • RevstackConfig - Configuration object for the provider
  • Entitlement - Entitlement response shape
  • CheckoutParams - Parameters for checkout sessions

​
Usage

"use client";

import { RevstackProvider } from '@revstackhq/next/client';
import { ReactNode } from 'react';

interface ProvidersProps {
  children: ReactNode;
}

export function Providers({ children }: ProvidersProps) {
  const config = {
    publicKey: process.env.NEXT_PUBLIC_REVSTACK_KEY!,
    getToken: async () => {
      // Fetch from your auth system
      return sessionStorage.getItem('token');
    },
  };

  return (
    <RevstackProvider config={config}>
      {children}
    </RevstackProvider>
  );
}

​
API Reference

For detailed documentation of each export, see:

React Hooks

useRevstack() and useEntitlement() documentation

React Components

RevstackProvider configuration and usage

​
Server vs Client

Do not import from @revstackhq/next/client in Server Components or Route Handlers.For server-side entitlement checks, use @revstackhq/next/server instead.
Client-side (@revstackhq/next/client):
  • ✅ Client Components ("use client")
  • ✅ Interactive UI and forms
  • ✅ Browser-based checkout flows
  • ❌ Server Components
  • ❌ Route Handlers
  • ❌ Server Actions
Server-side (@revstackhq/next/server):
  • ✅ Server Components
  • ✅ Route Handlers
  • ✅ Server Actions
  • ✅ API routes with usage metering
  • ❌ Client Components

Build docs developers (and LLMs) love

Get started for freeTalk to us