React Hooks

​

useRevstack

function useRevstack(): RevstackClient

• RevstackClient - The client instance configured in <RevstackProvider>

• Error if used outside of <RevstackProvider>

import { useRevstack } from '@revstackhq/react';

function MyComponent() {
  const client = useRevstack();
  
  const handleCheckout = async () => {
    await client.startCheckout({
      planId: 'plan_123',
      successUrl: '/success',
      cancelUrl: '/pricing',
    });
  };

  return <button onClick={handleCheckout}>Subscribe</button>;
}

​

useEntitlement

function useEntitlement(key: string): Entitlement

• key (string) - The feature key to check

• Entitlement object with:
  • key (string) - The feature key
  • hasAccess (boolean) - Whether the user has access
  • value? (string | number | boolean) - Optional limit or configuration value

import { useEntitlement } from '@revstackhq/react';

function FeatureGate() {
  const entitlement = useEntitlement('premium-feature');

  if (!entitlement.hasAccess) {
    return <UpgradePrompt />;
  }

  return <PremiumFeature />;
}

• Updates automatically when entitlements change
• Safe for server-side rendering
• Returns hasAccess: false during initial load and on server