CruiseHQ
City-Scale Social Operating System, Closed-Loop Microeconomy & DOM-Controlling Voice AI Concierge

Executive Architectural Overview
City-scale social graph, event ticketing engine, and real-time multiplayer arcade spanning 44 database migrations. Driven by TCG—a bidirectional voice AI concierge that interprets natural speech to execute client tool declarations and physically manipulate the React DOM in real time.
Core Architectural Accomplishments
Deterministic Guarantees
Integrated System Components
Voice-Controlled React DOM Engine (TCG)
TCG agent parses natural speech into client tool declarations (openTool, switchMode, analyzeImage), directly triggering React state transitions without human clicks.
3-Tier Sub-Second Caching Architecture
Queries check Supabase DB (7-day TTL) → Upstash Redis (15-min TTL) → Firecrawl Search API with automatic background cache replenishment, cutting query latency by 94%.
Closed-Loop $CRUISE Microeconomy
Atomic spend_cruise and grant_cruise RPCs with service-role security, split-at-source event ticket payouts, and affiliate commission attribution.
QR Multiplayer Room Engine & AUX Proxy
Enables instant frictionless room joining via mobile QR scan with Supabase Presence, crowd drops, real-time co-host voice streaming, and AES-256 encrypted Spotify AUX proxying.
Hardened Namespaced Schemas
Shared infrastructure with deny-by-default RLS, service-role-only ledger mutations, and HMAC-SHA256 webhook reconciliation.
Technology Architecture Matrix
- Next.js 15
- Tailwind CSS
- Serwist Offline PWA (220+ Routes)
- Presence Avatars
- Multimodal Client Tools
- Supabase PostgreSQL (44 Migrations)
- pgvector Semantic Search
- Atomic spend_cruise RPCs
- Service-Role Minting Guard
- Deny-by-Default RLS
- Gemini Multimodal Live API
- ElevenLabs Voice Pipeline
- 20+ Client Tool Handlers (switchMode, openTool)
- Supabase Broadcast & Presence
- Spotify AUX Proxy (AES-256)
- $CRUISE Closed-Loop Microeconomy
- Bachs Split-Checkout
- Cruisaider Commission Attributor
- Paystack Webhooks
- HMAC-SHA256 Webhook Verification