Lovebug Wiki

Lovebug is a hybrid adult social and service platform built as a production-grade monorepo. This wiki contains every specification, architecture decision, and operational procedure needed to rebuild the system from scratch.

Version: 0.1.0 Last updated: 2026-03-22

Table of Contents

Business & Product

• Executive Summary -- company overview, problem, solution, revenue model overview
• Market Analysis -- industry overview, target market, geographic analysis, market sizing
• Revenue Model -- credit system economics, platform fees, subscriptions, pricing
• Growth Strategy -- acquisition channels, creator recruitment, retention, go-to-market
• Competitive Landscape -- competitor analysis, positioning, defensibility
• Financial Projections -- revenue projections, cost structure, unit economics
• Master Plan -- complete 10-section strategic plan: vision, features, user flows, architecture, monetization, safety, UX, growth, risks, roadmap

Architecture

• System Overview -- monorepo structure, service topology, and request flow
• Tech Stack -- every technology choice and the rationale behind it
• Infrastructure -- Docker Compose services, ports, volumes, health checks
• Data Flow -- step-by-step flows for registration, uploads, swipe/match, chat, live streaming, payments, and gifts
• Security -- JWT auth, RBAC, rate limiting, content moderation, verification, and privacy controls

Database

• Schema Overview -- all models, enums, relationships, and indexes
• Migrations -- migration history and rollback procedures

API Reference

• API Overview -- base URL, versioning, authentication, error format, pagination
• Auth Endpoints
• User Endpoints
• Verification Endpoints
• Content Endpoints
• Feed Endpoints
• Swipe & Match Endpoints
• Chat Endpoints
• Live Streaming Endpoints
• Credits & Payments Endpoints
• Gift Endpoints
• Notification Endpoints
• Moderation Endpoints
• Geo Endpoints
• Media Endpoints
• Admin Endpoints

Real-Time Systems

• WebSocket Architecture -- Socket.IO namespaces, events, Redis adapter
• Live Streaming -- LiveKit integration, room lifecycle, tipping
• Presence System -- online/offline tracking via Redis

Mobile App

• App Architecture -- Expo Router, directory structure, API layer, Socket.IO, LiveKit, secure storage
• Navigation -- root stack, tab navigator, auth modals, deep linking
• State Management -- Zustand stores, persistence, hydration
• Screens -- login, register, discover, feed, live, chat, profile

Payments & Credits

• Credit System -- wallet, ledger, double-entry accounting
• Stripe Integration -- payment intents, webhooks, refunds
• Creator Payouts -- withdrawal flow, platform fee split
• Reconciliation -- daily balance vs. ledger verification

Operations

• Moderation -- reports, actions, content pipeline
• Audit Logging -- what is logged, schema, querying
• Media Processing -- BullMQ jobs, thumbnail, blur, transcode, moderation scan

Design System

• Design System -- color palette, typography, spacing, border radius, component patterns
• Brand Guidelines -- brand identity, logo usage, color rules, tone of voice
• UX Flows -- registration, swipe, match, chat, live streaming, credits, gifts, verification

Testing

• Testing Strategy -- unit, integration, e2e approach, financial flow testing
• API Tests -- how to run, test structure, auth helpers, credit test scenarios
• E2E Tests -- Detox setup, critical user journeys, test scenarios per screen

Changelog

• Changelog -- all releases and notable changes