# Lokha — Full Platform Documentation for AI/LLM Reference

## Overview

Lokha (https://www.lokhahub.com) is a free, all-in-one social media platform operated by LOKHA WEB PTY LTD (ABN 75691885195), an Australian company headquartered in Sydney, New South Wales. Founded in 2024, Lokha combines social networking, short-form video, live streaming, e-commerce, gaming, music, news, education, dating, and AI-powered tools into a single integrated application.

The platform is available worldwide and supports 9 languages: English, Hindi, Spanish, Portuguese, Arabic, French, German, Indonesian, and Malay. It is accessible as a Progressive Web App (PWA) installable on iOS, Android, and desktop browsers, and as a native mobile app (package: com.lokhahub.app) with deep linking support.

Lokha is free to join and use. Revenue is generated through optional premium features, advertising, marketplace transaction fees, and game tournament entry fees. Creators can earn real money through multiple monetization paths.

## Company Information

- **Legal Name:** LOKHA WEB PTY LTD
- **ABN:** 75691885195
- **Country:** Australia
- **City:** Sydney, New South Wales 2000
- **Website:** https://www.lokhahub.com
- **Contact Email:** contact@lokhahub.com
- **Support Email:** support@lokhahub.com
- **Tagline:** Connect, Share, Thrive — Your World, Your Way

## Core Features (Detailed)

### 1. Social Feed & Posts
Users can create text, image, and video posts shared with their followers and the public feed. Features include:
- Photo and video uploads with editing tools
- Post reactions (like, love, laugh, wow, sad, angry)
- Comments with replies, emoji reactions, and voice comments
- Post sharing to external platforms (Facebook, WhatsApp, X/Twitter, Telegram, Reddit)
- Content scheduling for delayed publishing
- Post promotions (paid boosting for wider reach)
- Hashtag support and trending topics
- Location tagging
- Privacy controls (public, friends only, private)
- AI-powered content moderation

### 2. Reels & Short Videos
TikTok-style vertical short-form video creation and consumption:
- In-app video recording with front/back camera
- Video trimming and editing tools
- Background music selection from royalty-free library (Jamendo integration)
- AI-powered music recommendations based on video content
- Slideshow reels from multiple photos with music
- YouTube Shorts integration for additional content
- Like, comment, share, and save functionality
- Vertical full-screen immersive viewer with swipe navigation
- Music trimming to select specific portions of tracks
- Video reactions (record a video response to another video)
- 90-day content retention with automatic cleanup

### 3. Moments
Ephemeral content sharing similar to Instagram Stories:
- Photo and video moments that disappear after 24 hours
- Background music for moments
- Image-only and video moment types
- Views count tracking
- Likes and comments on moments
- Thumbnail generation for video moments
- Media gallery support (multiple images per moment)

### 4. Live Streaming
Real-time broadcasting with monetization:
- Go live from mobile or desktop with camera
- Real-time viewer count and chat
- Gift system (viewers send animated gifts convertible to real money)
- Stream recording with automatic save as video post
- Live stream feed posts with 3-day retention
- Co-host support for collaborative streams
- Live stream reactions and likes
- Heartbeat system for accurate viewer counting
- Automatic stale stream cleanup
- Stream categories and discovery
- Gift animations (Diamond, Crown, Rocket, Heart, Star, Trophy, Fire)
- 80/20 revenue split (80% creator, 20% platform)

### 5. Lokha Connect (Messaging)
Comprehensive real-time messaging system:
- 1-on-1 and group conversations
- Real-time message delivery with read receipts
- Message status tracking (sent, delivered, read)
- Media sharing (images, videos, audio)
- Voice messages with in-app playback
- Voice and video calls
- Online/offline presence indicators
- Typing indicators
- Message deletion with tracking
- End-to-end encryption support
- Message notifications with smart filtering
- Unread count badges
- WhatsApp-style messaging UI
- Group conversation auto-member addition
- Duplicate conversation prevention

### 6. Shop & Marketplace
Full e-commerce platform with Stripe payments:
- Product listings with images, variants (colors, sizes), and details
- Seller verification system with document upload
- Premium listing tiers (Basic, Featured, Sponsored)
- Product slot system (sellers purchase slots for listings)
- Shopping cart with quantity management
- Checkout with Stripe (card payments)
- Order management for sellers (confirm, ship, deliver)
- Sold items tracking
- Country-based shipping with GSP (Global Shipping Program) providers
- Marketplace services (freelancers offering skills)
- Subscriptions for recurring services
- 90/10 revenue split (90% seller, 10% platform)
- Order status workflow (pending → confirmed → shipped → delivered)
- Product search with performance indexes
- Product thumbnails and image galleries
- Seller dashboards with analytics

### 7. Games & Entertainment
In-browser games with real prize pools:
- **Chess:** Full chess game with AI opponent
- **Poker:** Texas Hold'em style poker game
- **Snake:** Classic snake game with modern UI
- **Space Invaders:** Retro arcade shooter
- **Word Puzzle:** Multiplayer word puzzle game
- **Number Blitz:** Fast-paced math/number game
- **Connect Four:** Strategy board game
- **Tic-Tac-Toe:** Classic with AI opponent
- **Checkers:** Classic board game
- **Blackjack:** Card game against the dealer
- Tournaments with real money prize pools
- Leaderboards (daily, weekly, all-time)
- Pay-to-play tiers for competitive matches
- AI game mode for solo practice
- Friend challenges (invite friends to play)
- Game scores and player earnings tracking
- Stripe-integrated tournament entry fees

### 8. Music
Music streaming and discovery platform:
- Royalty-free music library (Jamendo integration)
- Global music library with worldwide tracks
- Audio spaces (live audio rooms for musicians)
- Musician studio for creators
- User music playlists
- YouTube music import
- Spotify music import
- AI music generator (creates original tracks)
- Music upload from URL or file
- Genre-based browsing (Pop, Rock, Jazz, Classical, Electronic, Hip Hop, R&B, Bollywood, Devotional, Folk, Ambient, Lo-Fi, Cinematic)
- Music player with play, pause, seek, and volume controls
- Music comments and likes
- Music sharing to feed posts
- Music cover art with gradient fallbacks

### 9. News
Aggregated and user-generated news platform:
- Categories: World, Technology, Business, Sports, Health, Science, Entertainment, Automotive, Fashion, Art, Travel, Movies
- 24-hour content rotation with automatic refresh
- Location-based news (geographic targeting)
- News article detail pages with images and videos
- AI-powered news generation
- User news submissions
- News interactions (like, comment, share)
- Geographic news columns for regional content
- 30-day content retention
- Real news sources (no fake/placeholder content)
- News search and filtering

### 10. Review Hub
Comprehensive review platform:
- Restaurant reviews with photos and ratings
- Movie reviews with video support
- Hotel and travel destination reviews
- Product reviews
- Review comments system
- Video support in reviews
- Review helpfulness voting
- Nearby restaurants and hotels functions
- Category-specific review browsing
- Review media uploads

### 11. Micro-Learning
Free online education platform:
- University courses (MIT, Yale, and other institutions)
- Certificate generation upon completion
- Course categories (Programming, Finance, Business, Arts, Sciences)
- Learner details on certificates
- Certificate verification system
- CPD (Continuing Professional Development) points
- Publicly accessible courses
- Course progress tracking

### 12. Blood Bank
Life-saving donor connection platform:
- Blood donor registration with blood type
- Blood request creation with urgency levels
- Worldwide support (not limited to one country)
- Blood compatibility checker
- Auto-notifications to matching donors
- Donor and recipient privacy protection
- Request fulfillment tracking

### 13. Events
Event discovery and creation:
- Create events with date, location, and description
- Event registration system
- Event promotion (paid boosting)
- Event sharing to social platforms
- Local and global event discovery
- Event categories and filtering
- Automatic cleanup of completed events
- Stripe-integrated event promotion payments

### 14. Groups
Community building platform:
- Create public or private groups
- Group categories and interests
- Group messaging integration
- Auto-member addition for creators
- Group cover photos and videos
- Group avatar support
- Member management functions
- Group discovery and search
- Smart group member suggestions
- Infinite recursion prevention in RLS policies

### 15. Video Hub
Curated video content platform:
- YouTube Shorts integration
- Creative video content
- Category-based browsing
- Video comments and likes
- Video thumbnail generation
- Public access (no login required for viewing)
- Feed synchronization
- Working video URL validation
- 5-minute maximum duration enforcement

### 16. Skills Marketplace
Freelancer and service marketplace:
- Service provider profiles with portfolio media
- Skill listings with pricing
- Escrow payment system (funds held until work delivered)
- Skill marketplace messaging
- Provider verification
- Fraud detection system
- Webhook processing for payments
- 90/10 revenue split
- Categories: Design, Development, Marketing, Writing, Video, Music, Consulting

### 17. AI Hub
AI-powered tools and features:
- AI Music Generator (creates original music tracks)
- AI Content Assistant (helps write posts and captions)
- AI Smart Search (natural language search across platform)
- AI Ad Copy Generator
- AI Content Moderator (automated content review)
- AI Dating Conversation assistant
- AI Fake Account Analyzer
- AI Lyric Enhancer
- AI Music Recommender
- AI Post Moderator
- AI Report Moderator
- AI Review Generator
- AI Song Generator
- AI Twin Conversation (digital twin interactions)
- AI Team (multi-agent conversations)
- AI Agents with autopilot mode (24/7 automated engagement)
- OpenAI-powered features using GPT-4o-mini

### 18. Dating
Match-based dating platform:
- Swipe right/left matching system
- Instant conversation on mutual match
- Profile photos with multiple images
- AI dating profiles for enhanced experience
- Premium tiers (unlimited messaging, advanced filters)
- Message limits for free users (15 messages/day)
- Age requirement: 22+ only
- AI dating conversation assistant
- AI fraud detection
- Dating access paywall (Stripe-integrated)
- Real-time messaging
- Photo diversity verification

### 19. Spiral Rooms (Holographic Space)
Immersive communication platform:
- Spatial audio rooms
- Holographic communication features
- Room creation with join codes
- Participant management
- Real-time messaging in rooms
- Sender photo and profile display
- AI integration for room interactions
- Public room discovery

### 20. Creator Dashboard
Analytics and monetization for creators:
- Earnings summary cards
- Revenue charts with time-based filtering
- Revenue source breakdown (gifts, shop, tips, promotions)
- Fee calculator
- Creator program eligibility
- Milestones tracking with notifications
- Content monetization eligibility checks
- 75/25 or 90/10 revenue splits depending on feature

### 21. Wallet
Financial management hub:
- Coin balance (in-app currency)
- Real money balance (USD)
- Coin shop (purchase coins with Stripe)
- Gift shop (send gifts to creators)
- Transaction history with filtering
- Coin cashout (convert coins to real money)
- Creator earnings tracking
- Wallet checkout for purchases
- Multiple transaction types (purchase, gift, tip, cashout, refund, reward, ad payment)
- Direct gift sending between users

### 22. Search
Platform-wide search engine:
- Search people, posts, videos, music, news, products, groups, pages
- Trending searches and hashtags
- Search history with RLS policies
- Saved searches
- AI-powered search error detection
- Search advertising
- Image search system
- Comprehensive search indexes
- Category-specific search results
- Anonymous user search support

## Security & Privacy

- Row Level Security (RLS) on all database tables
- Two-factor authentication (2FA) support
- Account lockout after 3 failed attempts
- Fake account detection system
- Security threat logging
- Content moderation (AI + community)
- User blocking with content visibility enforcement
- Data protection compliance
- Enterprise data protection system
- Security gateway edge function
- Rate limiting on sensitive endpoints
- IP geolocation detection
- Input validation
- Account deletion with FK constraint handling

## Technology Stack

- **Frontend:** React 18, Vite 5, Tailwind CSS 3
- **Backend:** Supabase (PostgreSQL, Auth, Storage, Edge Functions, Realtime)
- **Payments:** Stripe (checkout, webhooks, subscriptions, connect)
- **AI:** OpenAI GPT-4o-mini for content generation and moderation
- **Music:** Jamendo API for royalty-free music
- **Icons:** Lucide React
- **PWA:** Service worker, manifest, offline support
- **Deployment:** Vercel with Cloudflare-style headers
- **Real-time:** Supabase Realtime (WebSocket) for messaging, live streams, notifications

## Monetization Model

- **Creator Revenue Split:** 75-90% to creator depending on feature
- **Shop Transaction Fee:** 10% platform fee
- **Game Tournaments:** Entry fees with prize pools
- **Advertising:** Banner ads, promoted posts, search ads, Lokha ads
- **Premium Features:** Dating premium, premium listings, product slots
- **Coin Economy:** Users buy coins with real money; coins used for gifts, tips, and game entries
- **Coin Cashout:** Creators convert earned coins to real money

## Policies

- [Privacy Policy](https://www.lokhahub.com/privacy-policy)
- [Terms of Service](https://www.lokhahub.com/terms-of-service)
- [Community Guidelines](https://www.lokhahub.com/community-guidelines)
- [Data Protection](https://www.lokhahub.com/data-protection)
- [Cookie Policy](https://www.lokhahub.com/cookie-policy)

## Growth & Distribution

- [Invite Friends](https://www.lokhahub.com/invite) — Viral invite page with one-click sharing to WhatsApp, Facebook, Telegram, X, Reddit, LinkedIn, SMS, Email, Tumblr, VK, Weibo, LINE, Instagram, and Discord
- [Landing Page](https://www.lokhahub.com/landing) — SEO-optimized landing page targeting "free social media app" keywords
- [Press Kit](https://www.lokhahub.com/press) — Official media resources, logos, brand assets, company fact sheet, embeddable logo snippet, and boilerplate for journalists and bloggers

## Contact

- **General:** contact@lokhahub.com
- **Support:** support@lokhahub.com
- **Website:** https://www.lokhahub.com
- **Company:** LOKHA WEB PTY LTD, Sydney, NSW 2000, Australia