React + Python Setup

# Install Flask with async support
pip install flask[async]

# Install Lumen SDK with Flask support
pip install lumen-python-sdk[flask]

# Install Lumen SDK with FastAPI support
pip install lumen-python-sdk[fastapi]

# Install Lumen SDK with Django support
pip install lumen-python-sdk[django]

npx shadcn@latest add https://getlumen.dev/pricing-table.json
npx shadcn@latest add https://getlumen.dev/usage-badge.json

npx lumen add

# TypeScript
npx lumen add -l tsx -p src/components/pricing-table.tsx -y

# JavaScript
npx lumen add -l jsx -p src/components/pricing-table.jsx -y

from flask import Flask, request
from lumen.handlers import lumen_flask_handler

app = Flask(__name__)

# Your auth function
def get_user_id():
    # Example: Extract from JWT or session
    user_id = request.headers.get("X-User-ID")
    if not user_id:
        return None
    return user_id

# Lumen proxy route
@app.route("/api/lumen/<path:path>", methods=["GET", "POST", "PUT", "DELETE"])
def lumen_proxy(path):
    handler = lumen_flask_handler(get_user_id=get_user_id)
    return handler(path)

if __name__ == "__main__":
    app.run(port=5000)

from fastapi import FastAPI, Request, HTTPException
from lumen.handlers import lumen_fastapi_handler

app = FastAPI()

# Your auth function
def get_user_id(request: Request):
    # Example: Extract from JWT or session
    user_id = getattr(request.state, "user_id", None)
    if not user_id:
        raise HTTPException(status_code=401, detail="Unauthorized")
    return user_id

# Create handler
handler = lumen_fastapi_handler(get_user_id=get_user_id)

# Lumen proxy route
@app.api_route("/api/lumen/{path:path}", methods=["GET", "POST", "PUT", "DELETE"])
async def lumen_proxy(request: Request, path: str):
    return await handler(request, path)

# views.py
from lumen.handlers import lumen_django_handler

def get_user_id(request):
    if not request.user.is_authenticated:
        return None
    return str(request.user.id)

lumen_view = lumen_django_handler(get_user_id=get_user_id)

# urls.py
from django.urls import path
from .views import lumen_view

urlpatterns = [
    path('api/lumen/<path:path>', lumen_view),
]

npm install @getlumen/better-auth

import { LumenPlugin } from "@getlumen/better-auth";

export const auth = betterAuth({
  plugins: [ LumenPlugin({ apiKey: process.env.LUMEN_API_KEY! }) ],
});

import { useFeature } from "@getlumen/react";

const { entitled } = useFeature(userId, "access-to-live-customer-service");

if (!entitled) return null;

return <LiveChatWidget />;

import { FeatureGate, Paywall } from "@getlumen/react";

// Simple: Render null if not entitled
<FeatureGate
  userId={userId}
  feature="access-to-live-customer-service"
>
  <LiveChatWidget />
</FeatureGate>

// Upgrade Prompt: Show a paywall if not entitled
<Paywall
  userId={userId}
  feature="access-to-live-customer-service"
  onUpgrade={() => navigate('/pricing')}
>
  <LiveChatWidget />
</Paywall>

import { useUsageQuota } from "@getlumen/react";

const { used, limit, percentage } = useUsageQuota(userId, "api-calls");

<UsageBadge
  featureSlug="api-calls"
  label="API Calls"
/>

from lumen import send_event, is_feature_entitled

@app.route('/api/expensive-operation', methods=['POST'])
async def expensive_operation():
    user_id = get_user_id()

    # 1. SECURITY CHECK: Does the user have the feature?
    if not await is_feature_entitled(feature="api-calls", user_id=user_id):
        return {'error': 'Upgrade required'}, 403

    # 2. Execute Business Logic
    result = do_expensive_work()

    # 3. Track Usage
    await send_event(name="api-calls", user_id=user_id)

    return {'success': True, 'result': result}

from lumen import send_event, is_feature_entitled

@app.post('/api/expensive-operation')
async def expensive_operation(request: Request):
    user_id = get_user_id(request)

    # 1. SECURITY CHECK: Does the user have the feature?
    if not await is_feature_entitled(feature="api-calls", user_id=user_id):
        raise HTTPException(status_code=403, detail="Upgrade required")

    # 2. Execute Business Logic
    result = await do_expensive_work()

    # 3. Track Usage
    await send_event(name="api-calls", user_id=user_id)

    return {'success': True, 'result': result}

from lumen import send_event, is_feature_entitled
from django.http import JsonResponse

async def expensive_operation(request):
    user_id = str(request.user.id)

    # 1. SECURITY CHECK: Does the user have the feature?
    if not await is_feature_entitled(feature="api-calls", user_id=user_id):
        return JsonResponse({'error': 'Upgrade required'}, status=403)

    # 2. Execute Business Logic
    result = do_expensive_work()

    # 3. Track Usage
    await send_event(name="api-calls", user_id=user_id)

    return JsonResponse({'success': True, 'result': result})