Loom Loyalty Hub

The Loom Loyalty Hub is an open-source, schema-driven admin framework for building multi-tenant loyalty program management interfaces. It provides a complete solution for managing customers, tiers, badges, targets, offers, and more.

Key Features

• Schema-Driven UI - Automatically generates forms and views from your data models
• Multi-Tenant Architecture - Single deployment serves multiple organizations
• Custom Components - Extend with your own widgets and views
• WorkOS Authentication - Enterprise-grade SSO and user management
• Cloudflare Workers - Edge deployment for global performance

Architecture

┌─────────────────────────────────────────────────────────────┐
│                    Loom Loyalty Hub                         │
│  ┌─────────────────────────────────────────────────────────┐│
│  │                    React Application                    ││
│  │  ┌───────────┐ ┌───────────┐ ┌───────────┐              ││
│  │  │   Routes  │ │ Providers │ │Components │              ││
│  │  └───────────┘ └───────────┘ └───────────┘              ││
│  └─────────────────────────────────────────────────────────┘│
│  ┌─────────────────────────────────────────────────────────┐│
│  │                  @loom-loyalty packages                 ││
│  │  ┌───────┐ ┌──────┐ ┌────────┐ ┌─────┐                  ││
│  │  │  core │ │  ui  │ │ schema │ │ sdk │                  ││
│  │  └───────┘ └──────┘ └────────┘ └─────┘                  ││
│  └─────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────┘
             │                               │
             ▼                               ▼
┌─────────────────────────────┐ ┌─────────────────────────────┐
│      Cloudflare Worker      │ │        Platform API         │
│ Serves SPA static assets    │ │ Browser calls /hub-configs  │
│ Proxies /api/ai/* to AI_URL │ │ and domain APIs directly    │
└─────────────────────────────┘ └─────────────────────────────┘

Packages

Package	Description
@loom-loyalty/core	Provider interfaces, hooks, plugin system
@loom-loyalty/ui	70+ React components with Radix UI
@loom-loyalty/schema	JSON Schema parser and UI schema generator
@loom-loyalty/sdk	Generated API client with TanStack Query

Quick Links

• Getting Started - Set up your first Hub instance
• Configuration - Configure branding and features
• Custom Components - Build custom widgets and views
• Authentication - Set up WorkOS SSO
• Deployment - Deploy to Cloudflare Workers