🚀 Overview

Hugme is a full-featured Android native dating platform designed for real-time connections:
profiles, swipes/matches, chat, audio/video calls, and live streaming rooms. Built around real-world dating app workflows
(onboarding, discovery, safety prompts, consent cues, and reporting), it’s ideal for launching branded communities and niche dating networks.

Who it’s for: founders, agencies, and communities that want a white-label dating app with modern engagement and trust tools.

✨ Key Features

• Modern Profiles: Photos, bio, interests, pronouns, lifestyle tags, verification badges.
• Smart Discovery: Swipe stack & grid views with distance/age/gender filters and boosts.
• Real-time Chat: 1:1 messaging, read receipts, typing, media & voice notes.
• Audio/Video Calls: SDK-based low-latency calls with mute/switch camera & network fallback.
• Live Streaming: Host/guest streams, gifts/coins, viewer limits, and basic moderation tools.
• Safety & Consent: Photo blurring, block/report, keyword filters, and safety reminders.
• Location Aware: City/region discovery (no exact GPS sharing by default).
• Monetization: Coins, premium tiers, boosts, super likes, and subscription paywalls.
• Notifications: Push for matches, messages, calls, and live events.
• Admin Console: User flags, content takedown, stream controls, and analytics.
• Localization: Multi-language UI and RTL support.
• Accessibility: Dynamic type, contrast-friendly palette, and talkback labels.

⚙️ Technical Stack

• Mobile: Android (Kotlin/Java), MVVM, Retrofit/WebSockets, ExoPlayer for media.
• Calls/Streaming: Agora/WebRTC SDK (version-dependent) for voice/video & RTM.
• Backend: Laravel or Node.js REST API (depending on package), JWT auth.
• Realtime & Push: Firebase Cloud Messaging; optional Firebase Realtime/Firestore for presence.
• Storage/CDN: S3/Cloudflare/Wasabi for images & clips; signed URLs recommended.
• Server Requirements: PHP 8+/Node 18+, MySQL/MariaDB, HTTPS, OpenSSL, cURL, JSON, ZIP, PDO.

🧩 Installation Guide

1. Backend: Deploy API → set .env (DB, mail, storage, JWT, call/stream keys) → run migrations/seeders.
2. Android App: Open in Android Studio → set BASE_API_URL and SDK keys → gradle sync.
3. Push & Auth: Configure Firebase (FCM); enable phone/email/social sign-in as desired.
4. Branding: Replace app name, icons, splash, colors, and feature flags (gifts/coins, live, etc.).
5. Build & Release: Generate signed AAB/APK → prepare Play Store listing & privacy policy.

📦 Deliverables

• Android native source code (dating + chat + calls + live modules).
• Backend API source (Laravel/Node) with migrations & seed data.
• Integration for call/stream SDK and Firebase push.
• Admin dashboard (users, reports, content, revenue).
• Documentation: setup, environment variables, and publishing checklist.

📱 Supported Platforms

• Android: 6.0+ (API 23+), phones & tablets.
• Admin Panel: Web browsers (Chrome, Firefox, Safari, Edge).

🧠 Notes & Best Practices

• License: Distributed under the GPL; you may use, study, modify, and redistribute per GPL terms.
• Safety & Moderation: Enable age-gating (18+), proactive filters, rate limits, screenshot warnings, and a fast takedown flow.
• Privacy & Security: Enforce HTTPS; hash credentials; protect exact location; log moderation actions; outline consent in ToS.
• Compliance: Follow local dating/UGC rules, telecom/VoIP regulations, and store policies (Google Play).
• SEO Assurance: Public marketing pages include meta/schema hooks; private user areas are noindex.

👨‍💻 Original Developer Credit

We acknowledge the original developer and marketplace publisher as the authoritative source for Hugme’s concept.
For provenance and official updates, please refer to the original listing on
CodeCanyon (or the developer’s site).

🔒 Legal Disclaimer & GPL Redistribution

This is a GPL redistribution of source code for educational and compliant commercial use. You are solely responsible
for implementing age verification, content moderation, consent standards, and lawful streaming/call usage.
No endorsement or affiliation with the original authors is claimed. All trademarks remain the property of their respective owners.