Architecture Overview

PlaylogiQ is built as a Turborepo monorepo with Next.js 15, Supabase, and Vercel.

Monorepo Structure

apps/
  web/      — Operator Dashboard
  player/   — Player Portal
  api/      — Public REST API (v1)
  docs/     — This documentation

packages/
  ui/           — Shared UI components
  db/           — Database types & client
  auth/         — Auth utilities & RBAC
  gamification/ — Gamification engine
  crm-core/     — CRM & segmentation
  notifications/— Omnichannel notifications
  analytics/    — Analytics engine
  bonus-engine/ — Bonus & wagering
  i18n/         — Translations (EN/IT/ES)
  sdk/          — Public SDK
  config/       — Shared configs

Multi-Tenancy

Every table includes a tenant_id column. Row Level Security (RLS) policies on Supabase ensure complete data isolation between operators.

Real-time

Supabase Realtime powers live dashboards, leaderboards, and in-app notifications.

API Reference Index