SnapReels | Short Drama Streaming SAAS Script with Android App v1.1.9

Version 1.1.9 (Current Update) – 16-09-2026
=== [NEW FEATURES & MAJOR ADDITIONS] ===

* [Feature - Video Player Watermark Overlay System (Web & Native Android)] Implemented a comprehensive brand protection and logo watermark system across the Admin Panel, Web Video Player, and Native Android App:
* **Admin Panel Settings (`/admin/settings/general`)**: Dedicated controls to toggle the watermark ON/OFF, upload transparent PNG/WEBP/SVG logos with instant live preview and single-click removal.
* **Customizable Placement**: 4-position selector allows positioning the watermark in any corner (Top Right, Top Left, Bottom Right, Bottom Left).
* **Adjustable Opacity**: Configurable transparency levels (100% Solid, 80% Recommended, 60% Subtle, 40% Ghost) ensuring an optimal balance between brand visibility and viewing immersion.
* **Web Video Player Overlay**: Dynamically positioned overlay on top of the web player container with non-blocking pointer events (`pointer-events-none`) for uninterrupted scrubbing and player controls.
* **Native Android Jetpack Compose Integration**: Seamless Coil `AsyncImage` overlay implemented in both `VideoPlayerScreen.kt` and `ShortsScreen.kt`, respecting safe window insets, camera cutouts, and bottom playback controls.

* [Monetization - Google AdMob App Open Ads (On App Launch)] Integrated high-converting AdMob App Open Ads to maximize publisher revenue upon app launch:
* **Admin Mobile Settings (`/admin/settings/mobile`)**: Added dynamic App Open Ad controls under the Google AdMob configuration section with real-time toggle and Ad Unit ID field.
* **Mobile API Delivery**: Automatically synchronized to mobile devices via `/api/mobile/v1/settings`.
* **Native Android Integration**: Implemented in `AdsManager.kt` and triggered in `MainActivity.kt` using Google Play Services Ads SDK `AppOpenAd`, presenting an ad on application launch once remote configurations are fetched.

* [Feature - Referral & Invite Friends Viral Growth Engine] Implemented an end-to-end viral growth referral system across both Web Platform and Native Android App:
* Each registered user automatically receives a unique referral code (`SNAP-<UID>`) upon registration.
* Integrated a modern, high-converting Referral & Invite Card directly in the Web Wallet page and the Android App (`RewardsScreen`) with 1-tap clipboard copying, native Android system Share Sheet / WhatsApp fallback, and real-time invite analytics (Friends Invited, Total Coins Earned).
* Interactive invite code redemption modal allowing new users to redeem friend codes and instantly receive configurable bonus coins.
* Added dedicated Admin Settings controls (`/admin/settings/general`) to enable/disable the referral system, customize Inviter reward coins, and configure Invitee welcome bonus coins.
* Full transaction auditing: logs distinct `referral` ledger transactions for both inviter and invitee in MongoDB.

* [Feature - Dynamic Social Share Landing Page & Rich Previews] Created an intelligent social sharing landing page (`/share/[...slug]`) with cinematic presentation and responsive design:
* Dynamic OpenGraph and Twitter card metadata generation (`generateMetadata`) displaying high-resolution movie posters, rating , total episodes, genre chips, and synopsis when shared across WhatsApp, Facebook, X/Twitter, and Telegram.
* Smart action buttons:
* **Watch in SnapReels App**: Uses Chrome Intent URI (`intent://drama/{id}...`) to launch the installed Native Android App directly to the series, or gracefully redirects to the Google Play Store if the app is not installed.
* **Watch on Website**: One-tap link to stream directly via the web player (`/[lang]/series/[id]`).
* **Apple App Store**: Dedicated badge redirecting iOS users to the App Store.
* Configured Next.js `middleware.ts` to bypass i18n locale rewrites for `/share` paths, guaranteeing 100% resolution without 404 errors.

* [Mobile - Android Native Deep Linking Engine] Implemented end-to-end deep linking integration across the Native Android application:
* Configured `AndroidManifest.xml` with `singleTask` launch mode and intent filters supporting both custom schemes (`snapreels://drama/...`, `snapreels://share/...`) and HTTPS URLs (`https://.../share/...`).
* Added intent resolution in `MainActivity.kt` and `SnapReelsViewModel.kt` to parse incoming drama IDs and automatically navigate users directly to the Series Details & Player screens on link click.

* [Payment Gateways - Multi-Gateway Expansion (PhonePe, Cashfree, PayU)] Added full integration for PhonePe, Cashfree, and PayU payment gateways across the Admin Panel (`/admin/settings/payment-gateway`), backend checkout endpoints (`/api/checkout`, `/api/user/...`), web wallet, and Android Native App:
* Added dynamic controls in Admin Panel to toggle ON/OFF and configure Merchant IDs, Secret Keys, and logos.
* Extended `/api/mobile/v1/settings` API endpoint to deliver real-time gateway configurations to mobile clients.
* Android Native App dynamically displays checkout buttons for active gateways based on live server settings.

* [Feature - Episode Subtitles & Multi-Language Closed Captions (.vtt / .srt)] Added native support for multi-language subtitles and closed captions across episodes on both Web and Android Native apps:
* Administrators can easily attach subtitle tracks directly from the Episode Manager (`/admin/series/[id]/episodes`) by selecting from preset languages or entering custom language codes, via direct `.vtt`/`.srt` uploads or external URLs.
* Dedicated `/api/subtitles` endpoint with on-the-fly SRT to WebVTT conversion: automatically injects the `WEBVTT\n\n` header and converts comma timestamps (`00:00:01,000` -> `00:00:01.000`), ensuring 100% compliance with Media3 ExoPlayer specifications.
* Built custom high-contrast Compose Subtitle Overlays (pill background with bold white text) in both `VideoPlayerScreen.kt` and `ShortsScreen.kt`, listening directly to ExoPlayer's `onCues()`, ensuring crisp, legible captions regardless of device OS accessibility settings or control visibility.
* Interactive Subtitles `[CC]` toggle and language selection dropdown menu directly within `VideoPlayerScreen` and `ShortsScreen`.

* [Feature - Bulk Episodes Video Uploader] Introduced a high-productivity Bulk Episodes Video Uploader in the Admin Panel (`/admin/series/[id]/episodes`):
* Drag-and-drop dozens of video files at once (`.mp4`, `.mov`, `.webm`, `.mkv`, `.m3u8`, `.ts`) with intelligent natural numeric sorting (preventing alphabetical 1, 10, 2 ordering bugs).
* Automatic sequential episode numbering with customizable starting episode index.
* Throttled parallel worker uploads (2 concurrent streams to protect server bandwidth) with real-time progress bars per episode and overall queue.
* Automated single-batch database indexing with total episode count synchronization.

* [AI Engine - Google Gemini 2026 Upgrade & Multi-Model Suite] Upgraded Google Gemini AI engine to modern 2026 production models:
* Added support for `gemini-2.5-flash`, `gemini-3.5-flash`, and `gemini-3.8-flash` (with `gemini-flash-latest` and `gemini-2.5-pro` fallback) with automatic zero-downtime failover to absorb Google 503 high-demand and 429 rate limit spikes.
* Integrated OpenAI flagship models (`gpt-4o`, `gpt-4o-mini`, and `o3-mini`) with dynamic failover for structured drama metadata generation and high-precision translations.
* Added Groq multi-model engine (`qwen/qwen3.8-27b`, `llama-3.3-70b-versatile`, `llama-3.1-8b-instant`, `openai/gpt-oss`) with high-throughput OTPM rate-limit batching.
* Redesigned AI settings in `/admin/settings/plugins` with transparent model selection labels, live model badges, and an interactive "Test Connection" diagnostic button.

* [Admin Panel - Mobile App Share & Deep Links Settings] Added a dedicated "Share Page & Deep Links" configuration tab under `/admin/settings/mobile`:
* Empowers administrators to customize the Android package name (`com.snapreels.devsnaplix`), Google Play Store URL, and Apple App Store URL directly from the dashboard.
* Allows toggling individual buttons (Watch in App, Watch on Web, App Store) on or off in real-time.
* Extended `/api/mobile/v1/settings` API endpoint to deliver real-time share configurations to all client platforms.

=== [STREAMING ENGINE, SHORTS & PLAYER ENHANCEMENTS] ===

* [Streaming Engine - Universal HLS (.m3u8) & MPEG-TS (.ts) Web & Mobile Playback] Resolved playback limitations for HLS streams and direct MPEG-2 Transport Stream (`.ts`) video files across both Web and Android Native:
* **Server Access Security Normalization**: Updated Next.js `middleware.ts` and `/api/serve-uploads/[...path]` route to safely allow direct streaming of `.m3u8`, `.ts`, `.m4s`, and `.mpd` files without 403 Forbidden interruptions, adding HTTP 206 Partial Content Range support and full CORS headers.
* **Dynamic Virtual HLS Manifest Generator**: Created `/api/hls` endpoint that dynamically wraps any direct `.ts` video into an RFC-8216 compliant single-segment HLS playlist (`#EXTM3U ... #EXTINF: ... video.ts ... #EXT-X-ENDLIST`), enabling standard web browsers without native TS support to play TS streams seamlessly.
* **Web Player HLS Engine**: Integrated and bundled `hls.js` (v1.7.3) directly into the Next.js web player (`series-detail-view.tsx`) with automatic `.ts` detection, URL rewriting, and low-latency buffer tuning.
* **Android Native ExoPlayer Stream Engine**: Added official `androidx.media3:media3-exoplayer-hls:1.5.1` and `media3-exoplayer-dash:1.5.1` dependencies. Updated `VideoPlayerScreen.kt` and `ShortsScreen.kt` to load `.m3u8` streams via `HlsMediaSource.Factory(VideoCacheManager.getHttpDataSourceFactory())` with chunkless preparation, and configured `.ts` streams with explicit `MimeTypes.VIDEO_MP2T` for direct hardware decoding.
* **URL Normalization**: Guaranteed all relative video URLs (e.g. `/uploads/videos/...`) automatically resolve with the configured backend base domain across Android API parsers.
* **Subtitle Synchronization & De-duplication**: Resolved duplicate subtitle track entries and synced multi-language subtitle tracks seamlessly between the Web Player and Native Android Compose captions overlay.

* [Mobile Shorts - Randomized Multi-Episode Feed, High-Concurrency Loading & Instant Display] Completely re-architected the Shorts video feed to eliminate the "No Shorts available" stall and deliver instant, randomized ("3achwa2i") video streams:
* Replaced sequential blocking awaits with fully independent, concurrent coroutine workers across all candidate dramas (`launch(Dispatchers.IO)` with OkHttp 32-request concurrency pool).
* Engineered progressive unblocking: as soon as the very first candidate drama resolves its episodes (~100ms), it immediately populates the feed and dismisses the loading spinner so playback begins instantly without waiting for other dramas.
* Implemented a multi-tier catalog fallback chain: if the user's active language returns 0 series, the system automatically falls back to English, and then to all available dramas, guaranteeing the Shorts feed is never empty regardless of device locale.
* Added two-tier persistent disk caching (`snapreels_cache`) for both the aggregated Shorts playlist and individual drama episode lists, enabling instant 0ms startup on subsequent visits.
* Randomized episode selection: dynamically samples random distinct episodes from each drama's pool rather than repeating Episode 1, continuously shuffling the feed for fresh content.
* Hardened JSON parsing in `SnapReelsRepository.kt` with `optString`/`optInt` and format guards, preventing empty state triggers.

* [Mobile Performance & Stability - Shorts Playback Engine & Tab Transitions]:
* Eliminated tab-switching playback freeze by removing the restrictive `isHomeActive` state constraint, allowing ExoPlayer to transition smoothly between app tabs.
* Added per-request timeout safety and strict video URL validation to filter out HTML iframe/embed tags that cannot be parsed by native ExoPlayer.
* Integrated automated prefetch on mount (`LaunchedEffect`) and an empty state fallback with an interactive "Retry" button.
* Added `onPlayerError` listener in `ShortsPageItem` to immediately dismiss buffering spinners and recover from network drops.

=== [SECURITY, STABILITY & UI/UX OPTIMIZATIONS] ===

* [Mobile UI/UX - Camera Notch & Top Cutout Insets] Adjusted Home screen top header padding to safely accommodate front-facing camera cutouts (punch-hole and teardrop notches). Replaced zero-inset immersive top spacing with an ergonomic 36.dp safe buffer, ensuring logo, coins, rewards, and search buttons never overlap device camera hardware.

* [Mobile Security & Stability - Global Guest Authentication Guards] Hardened all user-data interactive triggers across the Native Android application:
* Integrated proactive login redirection (`navController.navigate("login")`) when unauthenticated guests tap Header Coins, Header Rewards, Hero Carousel Bookmarks, "Top Up" wallet buttons, "Join VIP" pass buttons, "Earn Rewards" tasks, locked episodes in the episode selector, or attempt to unlock episodes in `VideoPlayerScreen` and `DramaDetailScreen`.
* Guarded `TopUpScreen` and `RewardsScreen` with reactive auth observers to prevent unauthenticated guests from ever entering transactional or reward state flows, eliminating crashes and inconsistent states.

* [Rewards & Anti-Cheat System] Implemented intelligent Lifecycle & Visibility detection for Social Media and External Link tasks across both the Android App and React Web App:
* If a user returns or switches tabs before the required duration (e.g., 15s on Facebook/Instagram), the timer automatically cancels and prevents unfair coin claiming.
* Added an interactive "Task Incomplete" warning dialog in the Android App that clearly displays how many seconds the user stayed versus the required duration, featuring a 1-tap "Continue Task" button to resume and complete the task seamlessly.
* Hardened One-Time Task Claiming with instant local SharedPreferences caching and remote database synchronization, ensuring claimed tasks permanently disappear and can never be re-farmed or re-claimed by the same user.
* Added full multi-language translations for the new Task Incomplete dialog system across English, Arabic (`values-ar`), Hindi (`values-hi`), and Simplified Chinese (`values-zh`, `values-zh-rCN`).
* Integrated HTML5 Page Visibility API on Web Rewards page to ensure users remain focused on sponsored links for the full duration.

* [Mobile Performance & 60/120fps Scrolling Optimization] Conducted an end-to-end performance audit and optimization on the Native Android App (Kotlin / Jetpack Compose) to guarantee smooth 60/120fps browsing:
* Created `SnapReelsApplication` implementing Coil's `ImageLoaderFactory` with a dedicated dual-layer caching engine: 25% allocated device RAM MemoryCache, 250MB persistent DiskCache (`cacheDir/image_cache`), `respectCacheHeaders(false)` (preventing repeated network requests when scrolling past posters), and hardware bitmap acceleration.
* Eliminated heavy GPU render-effect stutter on scrolling by removing `Modifier.blur(50.dp)` from the dynamic home backdrop, replacing it with a fluid alpha-gradient scrim.
* Removed `BoxWithConstraints` subcomposition from `HomeSeriesSection`, preventing expensive remeasurement passes on each scroll event.

* [Admin Panel Stability & Documentation Setup]:
* Configured dynamic server rendering across Admin panel layout to prevent Next.js dynamic server usage errors on production deployments.
* Updated `Documontation/android.html` with step-by-step setup for OneSignal Push Notifications on Android, clarifying Firebase Admin SDK configuration under **Settings > Authentication** and OneSignal App ID setup.

Version 1.1.8 (Current Update) – 07-09-2026
* [Mobile UI/UX] Redesigned Android Home Page Hero Carousel to a vertical portrait format (3:4 ratio) displaying the drama "Poster / Cover Image" (`coverUrl`) instead of wide landscape banners, perfectly matching commercial short-drama apps like DramaBox and ReelShort.
* [Mobile UI/UX] Added dynamic cinematic ambient lighting behind the Hero Carousel that dynamically blurs and glows with the colors of the active drama poster.
* [Mobile UI/UX] Added dedicated "Top 10 Rankings" section featuring stylized giant ranking numbers (Gold #1, Silver #2, Bronze #3) overlapping each poster card.
* [Mobile UI/UX] Configured true full-screen immersive mode across the entire app with auto-hiding system navigation and status bars (`BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE`), eliminating bottom/top black letterboxing.
* [Mobile UI/UX] Removed the hardcoded 9.2 rating badge from the Featured hero carousel cards.
* [Mobile UI/UX] Completely revamped Series Details & Info page: removed hardcoded 4.8 rating, introduced high-contrast cinematic backdrop, localized metadata pills (HD, Episodes, Year), expandable synopsis, and fast "My List" & native Share buttons.
* [Mobile UI/UX] Cleaned up episode list titles to eliminate repetitive labels (e.g., duplicate "Episode 1 / Episode 1").
* [Mobile UI/UX] Streamlined Home Page layout by removing the redundant 4-card Quick Actions Bar (Rankings, Rewards, Coins, Shorts) for a cleaner, modern streaming aesthetic.
* [Mobile Performance] Fixed Home Page startup latency by implementing an instant Cache-First architecture with local SharedPreferences, completely removing artificial delays so the app loads in 0ms.
* [Mobile Fix] Fixed false "Check your internet connection" error when selecting empty categories: correctly distinguishes true network failures from empty filters, and automatically hides empty categories from the filter chips.
* [Mobile Localization] Completed 100% translation of all Android app strings for Hindi (`values-hi`) and Simplified Chinese (`values-zh`, `values-zh-rCN`), eliminating previous untranslated English fallbacks.
* [Mobile Localization] Added multi-language Category & Genre translation engine (`CategoryTranslator`) supporting English, Arabic, Simplified Chinese, and Hindi with automatic cross-lingual matching.
* [Mobile Fix] Fixed Android language switcher locale tag parsing for regional codes (such as `zh-CN`) to guarantee immediate UI language changes without app reload.
* [Mobile Feature] Integrated direct playback ("Watch Now"), 1-tap Watchlist bookmarking, and Series Details navigation directly on the Hero Carousel cards.
* [Mobile Performance] Replaced remote login background loading with an offline local drawable asset, completely eliminating network latency and white flashes on Sign-In.
* [Feature] Added full support for dynamic Multi-Payment Gateways: PhonePe, Cashfree, and PayU.
* [Feature] Added Payment Gateway controls to the Admin Panel to toggle ON/OFF and configure API Keys for PhonePe, Cashfree, and PayU dynamically.
* [Feature] The Android Native App now dynamically displays checkout buttons for the newly added payment methods based on real-time server settings.
* [Feature] Added UI options and automatic processing for PhonePe, Cashfree, and PayU in the React Web Frontend Wallet Checkout.
* [Performance] Implemented Server-Side Caching (Incremental Static Regeneration) on Home and Series Pages, completely eliminating slow TTFB and causing pages to load instantly.
* [Performance] Fixed severe FCP (First Contentful Paint) and CLS (Cumulative Layout Shift) issues by migrating from render-blocking Google Fonts links to optimized Next.js native fonts.
* [Performance] Created a robust MongoDB indexing script to supercharge database searches, filters, and episode loading for large catalogs without altering existing customer databases.
* [Security] Patched a critical backend vulnerability by enforcing rigorous Admin Session Verification (`verifyAdminSession`) across 36 Next.js Server Actions to prevent unauthorized API mutations.
* [Fix] Fixed an issue where the Installation Wizard was blocked at Step 4 ("Save & Continue") due to admin session enforcement before the admin account was created. Added dedicated `installSaveSiteConfigAction` with installation-state validation and robust error recovery.
* [Documentation] Added comprehensive Server & Hardware Environment Requirements (Node.js 18/20 LTS, MongoDB 5+, RAM, CPU, Storage, and 0% PHP clarification) to documentation and CodeCanyon listing metadata so buyers can evaluate environment compatibility before purchasing.
* [Documentation & Mobile] Replaced real/ambiguous API credentials in `AppConfig.kt` and `android.html` with clean placeholders (`YOUR_DOMAIN_HERE`, `YOUR_API_KEY_HERE`) accompanied by detailed guidance for locating and generating secret keys in Admin Panel (Settings > Mobile App).
* [Documentation] Fixed responsive layout and sidebar overlap bug in `admin_guide.html` and across all documentation pages using modern sticky-flex CSS architecture.
* [Documentation] Added 5 high-resolution authentic admin UI demonstration screenshots (admin_add_series.png, admin_add_episode.png, admin_coin_packs.png, admin_payment_gateways.png, admin_user_history.png) with 100% verified asset references and zero missing images.

Version 1.1.7 (Current Update) – 26-08-2026
* [Feature] Added new App Store and Google Play Store download badges to the website footer.
* [Feature] Automated IndexNow SEO ping to Bing/Yandex whenever a drama series is published or edited.
* [Feature] Added a Search Bar to the Users Admin Panel to quickly find accounts by Name, Email, or ID.
* [Security] Implemented IP Rate Limiting to prevent automated bot spam on the user registration endpoints.
* [Fix] Fixed an issue with Custom Pages (like Privacy Policy) not showing in the website footer.
* [Fix] Fixed a bug preventing the Sendmail configuration from saving properly in Security Settings.
* [Mobile App Update] Upgraded Google Play Billing Library to version 9.1.0 to comply with Google Play's mandatory policies (August 2026 requirement) and support the latest monetization features.
* [Feature] Added a completely new, polished First-Time Onboarding Experience (Welcome Slides, Feature Highlights, Language Selection) for new Android app users.
* [Fix] Fixed layout glitches when switching to the Arabic language (Right-to-Left Layout is now correctly enforced instantly without app restart).
* [Fix] Added missing Arabic translations for all the new onboarding interface elements.
* [Fix] Resolved a critical backend issue that crashed the Password Reset functionality due to improper parsing of the Firebase Admin Service Account JSON.

Version 1.1.6 (Current Update) – 12-08-2026
* [Feature] Added IndexNow API integration to the Admin Panel (Settings > Plugins) for instant search engine indexing.
* [Feature] The IndexNow API Key is served dynamically via middleware, requiring no manual server restarts (PM2) after generation.
* [Fix] Added automatic cleanup for the old IndexNow `.txt` file in the `/public` directory when generating a new key.
* [Fix] Resolved an issue with Groq Cloud AI integration in the admin panel.
* [Fix] Fixed user management bugs in the Admin Panel to ensure proper data handling.
* [Fix] Resolved an authentication issue that was creating malformed accounts (e.g., `[email protected]`).
* [Doc] Added Architecture Overview and End-User Experience sections to the main documentation index.
* [Doc] Reorganized the Admin Guide into detailed walkthroughs for Content, Monetization, and User Management.
* [Doc] Added comprehensive instructions for setting up Firebase Cloud Messaging (FCM) Push Notifications for Android.
* [Doc] Fixed step numbering and removed duplicate configuration steps in the Android App Setup guide.
* [Doc] Added specific troubleshooting steps for "Video Player Retrying Connection / Spinning Forever" issues.
* [Doc] Added a critical "Pre-Upgrade Backup" step to the Upgrade & Migration Guide.
* [Security] Removed sensitive plain-text admin credentials from the demo environment and public documentation.

Version 1.1.5 (Current Update) – 06-08-2026

* [Feature] Added full support for HLS (`.m3u8`) video streaming, allowing direct loading from external servers without heavy proxy buffering.
* [Feature] Upgraded the Admin Panel upload validation to detect and support `.m3u8` and `.ts` chunk files with correct `application/x-mpegURL` MIME types.
* [Mobile App Update] Replaced the legacy `VideoView` with Google's modern `ExoPlayer` in the Android App's Shorts feed, resolving buffering delays and adding `VideoCacheManager` background caching support.
* [Mobile App Update] Fixed an issue where Embed Videos would restart from the beginning when the device orientation (rotation) was changed by enabling configuration state persistence in `AndroidManifest.xml`.
* [Fix] Fixed an issue with Phone Authentication where the generated user email and display name would default to the long 28-character Firebase UID. It now intelligently generates a clean 8-digit random ID (e.g., `[email protected]`).

Version 1.1.4 (Current Update) - 31-07-2026
----------------------------------------

* [Feature] Added Phone Number Authentication (OTP Login) support across both the Web Application and the Android App.
* [Feature] Added "Forgot Password" and secure password reset workflows for Admin users.
* [Feature] Added "Forgot Password" and secure password reset workflows for regular App users.
* [Feature] Introduced Rate Limiting controls in `/admin/settings/security` including "Max Failed Logins per IP / Day" (Number of incorrect attempts before blocking the IP address for 24 hours) and "Max Password Resets / Day" to prevent brute-force and spam attacks.
* [Mobile App Update] Fixed an issue where Embed Videos were not playing correctly in the Android App by improving the native WebView player fallback.
* [UI/UX] Renamed "Mail Configuration" to "Security" in the Admin Panel and updated its URL slug/link references for better clarity and alignment with Firebase Service Account inputs.
* [Feature] Added dynamic default login credentials to the Admin Panel (`/admin/login`) that automatically populate only when `NEXT_PUBLIC_DEMO_MODE` is enabled.
* [Fix] Fixed an issue where the Admin Panel sidebar was incorrectly rendering on authentication pages (Forgot Password, Reset Password) by updating the `AdminLayoutShell` routing exclusions.
* [Fix] Resolved an `ESOCKET` TLS connection error preventing system emails from being sent (e.g. Password Resets) on shared hosts like cPanel by configuring the SMTP Mailer to allow self-signed certificates.
* [Fix] Fixed an issue where the "Login with Phone" button was missing from the Android App by adding `phoneLoginEnabled` to the mobile API settings synchronization endpoint.
* [Fix] Resolved the "Invalid Firebase Service Account JSON" error encountered when sending OTPs or Password Reset links by implementing a defensive regex parser that automatically fixes unescaped newlines (`\n`) introduced during copy-pasting into the Admin Panel.
* [Fix] Fixed a bug where the Firebase Service Account JSON field would sometimes fail to save in the Admin Panel Settings by ensuring it is properly tracked in the React Hook Form default values and backend allowlist.
* [Fix] Fixed a UI glitch in the Web App Authentication Modal where the phone number would get stuck in the OTP input field by resolving React DOM reconciliation key collisions.

Version 1.1.3 (Current Update) - 27-07-2026
----------------------------------------

* [Doc] Reorganized the FAQ & Troubleshooting page into categorized sections (GadoHost, VPS, Android App, Admin Panel) for easier navigation.
* [Doc] Added a dedicated Upgrade & Migration Guide (upgrade.html) detailing step-by-step instructions for updating on GadoHost and traditional VPS environments.
* [Doc] Expanded Android App setup documentation with detailed feature overviews, architecture notes, and Play Store release guides.
* [Fix] Added a troubleshooting guide for resolving the 500 Internal Error immediately after completing the installation wizard on GadoHost environments.
* [Fix] Upgraded Android video player to Google ExoPlayer (Media3) with DefaultMediaSourceFactory, resolving progressive streaming and playback compatibility issues.
* [Fix] Fixed video seeking interruptions and playback restarting from the beginning by implementing non-blocking slider state updates (onValueChangeFinished) in the Android App.
* [Fix] Fixed an issue in the Android App where long HD videos (14+ minutes) would reset their duration to 0 during buffering or stream transitions.
* [Fix] Fixed duplicate Range HTTP headers in the backend video proxy (api/video/route.ts) when streaming remote cloud videos.
* [Fix] Increased the local video streaming chunk size cap from 10MB to 500MB per request, supporting uninterrupted streaming and seeking for long High-Definition video reels.
* [Feature] Added background pre-buffering (pre-caching) for the next video reel in the Android App feed using Disk Cache Engine (VideoCacheManager) for instant, seamless swiping.
* [Security] Restricted license key validation checks to only apply to the `/admin` route, ensuring the public frontend website and video streams remain 100% accessible and operational without requiring license activation on root.
* [UI/UX] Modernized the Android App video player controls UI with a sleek custom layout featuring smooth progress bars, speed selectors, rewind/fast-forward buttons, and episode navigation.
* [UI/UX] Polished the Web Application Series Detail page with modern dark-mode aesthetics, responsive layouts, and smooth animations.
* [Feature] Created a custom, high-converting 404 Not Found error page with a sleek "Back to Home" button and neon aesthetic for both root and localized routes.
* [Fix] Fixed a database indexing error when fetching user comments in the Web Application by updating index constraints in the user action library.
* [Fix] Resolved 500 Internal Server Error occurrences on development and production web servers caused by Next.js/Turbopack build cache conflicts.
* [Fix] Eliminated slow video loading and the blocking "RETRYING CONNECTION..." spinner overlay on the Web Application by pre-calculating secure video URLs on the server before rendering and preventing ReactPlayer DOM unmounting when switching episodes.
* [Fix] Fixed an issue in the Web Application where video duration would show as 0:00 (e.g. 0:03 / 0:00) when playing or switching between episodes by implementing dynamic duration synchronization during playback progress and ready lifecycle events.
* [Fix] Resolved a runtime crash (ReferenceError: setIsRetrying is not defined) in the Web Application video player when clearing retry indicators during playback initialization.
* [Feature] Expanded Store Currencies in `/admin/coin-packs` to support all major global currencies (including Indian Rupee INR/₹, Nigerian Naira NGN, Kenyan Shilling KES, and more).
* [Feature] Added full integration for the Flutterwave Payment Gateway across both Web Application and Android Mobile App, supporting African and global payment methods with dynamic logo customization in `/admin/settings/payment-gateway`.
* [UI/UX] Redesigned the Web Application payment checkout dialog (`payment-dialog.tsx`) with compact, proportionate logo cards (`object-contain`) and streamlined height layouts, eliminating oversized logos and text distortion.
* [Fix] Added translation dictionary fallback text for Flutterwave checkout redirection to prevent raw underscore keys (`PAYMENT_DIALOG_FLUTTERWAVE_REDIRECT`) from displaying during payment processing.
* [UI/UX] Simplified Google Play In-App Billing settings in the Admin Panel by replacing unnecessary service account private key inputs with a clean informative card detailing direct Product ID recognition.
* [Update] Updated Groq Cloud AI integration from deprecated Llama 3.3 70B Versatile to the newer supported Llama 3.1 70B / Qwen 2.5 models across backend AI generation routes and Admin UI.
* [Feature] Streamlined Flutterwave Payment Gateway authentication in `/admin/settings/payment-gateway` and backend actions, allowing merchants to configure just their `Flutterwave Secret Key / API ID (FLWSECK)` without requiring a redundant Public Key.
* [UI/UX] Completely redesigned the Web Application checkout dialog (`payment-dialog.tsx`) into a sleek, vertical selectable list of payment cards ("Wahda taht whda"), replacing cramped horizontal tabs.
* [UI/UX] Refined checkout typography and visual layout by removing redundant description text, eliminating oversized logo containers, and formatting all payment gateway names in clean Title Case (`Stripe`, `PayPal`, `Razorpay`, `Flutterwave`).
* [UI/UX] Updated the primary checkout action button in the Web Application from all-caps `SECURE PAY & REDIRECT` to a clean, user-friendly `Continue Payment`.
* [Fix] Added `flutterwaveEnabled`, `currency`, and `currencySymbol` to the backend mobile API endpoint (`/api/mobile/v1/settings`), enabling proper synchronization between the Admin Panel and the Android App.
* [Fix] Fixed an issue in the Android App where Flutterwave was not displayed in the payment checkout list by updating the repository setting parser to read `flutterwaveEnabled`.
* [Fix] Fixed an issue in the Android App where coin pack prices and VIP subscriptions were hardcoded to US Dollars (`$`) by dynamically linking all price tags and checkout texts to the admin-defined store currency symbol (`currencySymbol`).

V1.1.2 - 07-07-2026

* [Fix] Fixed redirection loop (`ERR_TOO_MANY_REDIRECTS`) on the `/install` page in production builds by forcing dynamic rendering at runtime.
* [Fix] Fixed `500 Internal Server Error` on the `/admin/login` page after finishing the installation wizard by implementing lazy MongoDB connection caching, eliminating the need for a manual server restart.
* [Fix] Fixed `Application error: a client-side exception has occurred` React crash when navigating the dashboard while Google Translate extension is active.
* [Fix] Added a comprehensive list of languages to the admin panel and fixed an issue causing AI Translate to fail for language names containing international characters or parentheses.
* [Fix] Fixed an issue where changing the language wouldn't append the corresponding slug to the URL (e.g., `/pt-BR`) by separating the user's cookie preference from the site's global default locale in the routing middleware.
* [Fix] Fixed an issue where Google Analytics (GA4) was not tracking visitors or page views by rewriting the analytics tracking script injection to ensure the correct `arguments` object is properly passed to the Google Tag Manager `dataLayer`.
* [Feature] Improved Admin User Management by sorting the user list to show the most recently registered users first.
* [Feature] Added a detailed "User History" analytics modal in the Admin Panel that allows admins to view and track all coin transactions, rewards, and payments for any user with pagination support.
* [Feature] Added a "Welcome Bonus" setting in the Admin Panel (Settings > Authentication) to customize the number of free coins given to new users upon registration.
* [UI/UX] Modernized the Admin Dashboard typography by replacing ALL CAPS text with cleaner Title Case, replacing the date range calendar picker with a streamlined preset dropdown, and significantly improving mobile responsiveness across tables and widgets.
* [Fix] Fixed an issue where the SEO Settings and Authentication Settings (Welcome Bonus) were not saving in the Admin Panel by adding their respective keys to the backend's secure settings allowlist.
* [UI/UX] Fixed the UI layout for the Featured and Premium toggle switches in the Series Add/Edit form, resolving layout cramping and truncated labels on smaller screens.
* [Feature] Added an optional "Featured Image" upload field (16:9 aspect ratio, scaled to 1920px) for Drama Series, providing a dedicated banner for sliders that automatically falls back to the standard Poster image if left empty.
* [Mobile App Update] Updated the Kotlin Android App to dynamically load the Google Sign-in Web Client ID from `google-services.json` rather than using a hardcoded string, making authentication setup plug-and-play for buyers.
* [UI/UX] Redesigned the main Website Hero Slider to be an edge-to-edge cinematic banner with an optimized viewport height (vh), allowing content below it to peek into view. Moved pagination dots inside the slider to save vertical space.
* [UI/UX] Updated the Android App Featured Slider to support the new cinematic 16:9 aspect ratio, mirroring the premium look and feel of the website's hero section.
* [Fix] Added a bypass for Dailymotion video URLs to render as native HTML5 iframes automatically, resolving playback issues and the "Video Unavailable" error caused by ReactPlayer SDK timeouts.
* [Mobile App Update] Fixed the Android App failing to load "Embed Code" video sources by implementing an embedded WebView fallback specifically for iframe HTML strings.
* [Fix] Fixed the Admin Panel "Edit Episode" modal incorrectly reverting the Source Type from "Embed Code" to "Direct Link" for embed codes wrapped in tags.
* [Fix] Fixed the Website Video Player returning a "Retrying Connection..." error for ` embed codes by updating the global embed detection logic.
* [Fix] Fixed an issue where embedded video iframes would randomly reload or restart from the beginning when the user moved their mouse or triggered UI state changes.
* [Fix] Fixed slow video loading times and seek (skip) interruptions for large uploaded MP4 videos by rewriting the local video streaming API route to properly support HTTP 206 Partial Content (Range Requests) via Web ReadableStreams.
* [Fix] Fixed embedded videos (e.g., Dailymotion) appearing horizontally with a 16:9 aspect ratio inside the vertical player by forcing Tailwind overrides on inline padding CSS styles.
* [Fix] Fixed an issue where the Website only displayed the first Featured Drama in the slider if the interface language was changed to Arabic.
* [UI/UX] Added the Drama Title and a localized "Watch Now" overlay button to the Android App Featured Slider, mirroring the premium look and feel of the website.
* [UI/UX] Removed the blurred background edge-color from the Android App Featured Slider and Banner Ads to achieve a cleaner, edge-to-edge transparent appearance.

V1.1.1 - 26-06-2026

* Added full integration for bunny.net storage and CDN video streaming.
* Added Gemini AI support as a third AI provider for smart content automation.
* Redesigned the Website Homepage UI for better engagement and modern layouts.
* Major UI/UX redesign for the Android Mobile Application.
* Added configuration controls for Facebook Audience Network and AppLovin MAX ads.
* Added Multi-Ads Rotation Manager with ratios and priority settings.
* Optimized settings database collections for third-party plugins.
* Added AES-256-CBC token encryption for local and cloud video streams.
* Secured video routes using encrypted tokens instead of raw paths.
* Implemented middleware and API guards to block direct video access (403 Forbidden).
* Added automatic deletion of files when a Drama Series or Episode is removed.
* Added automatic cleanup for old images and videos during updates.
* Refactored Likes, Favorites and Share buttons to match Android UI.
* Integrated native Web Share API support.
* Added dynamic region extraction for cloud storage providers.
* Added client-side validation messages in the admin Series form.
* Enabled wildcard image domains support in next.config.ts.
* Updated documentation.
* Added a dedicated Mobile App settings section.
* Added Android App configuration panel.
* Added API Base URL management.
* Added API Access Key generation and management.
* Added mobile app version control and force update system.
* Added custom update URL configuration.
* Added Privacy Policy, Terms of Service and Rate Us links management.
* Added Google Play Billing support.
* Added enable/disable option for Google Play payments.
* Redesigned payment gateway settings.
* Added a dedicated Android Rewards System.
* Added separate Android Ad Rewards management.
* Added Android Daily Check-in reward configuration.
* Added Android reward task management panel.
* Added AI-powered metadata generator.
* Added automatic title, description and SEO metadata generation.
* Added automatic tags, categories and URL slug generation.
* Added OpenAI support as a second AI provider.
* Improved Groq Cloud integration and AI configuration panel.
* Added PayPal, Stripe and Razorpay payment logos.
* Improved performance, stability and mobile responsiveness.

V1.1.1 25-06-2026
- New: Added full integration for bunny.net storage and CDN video streaming.
- New: Added Gemini AI support as a third AI provider for smart content automation.
- Update: Redesigned the Website Homepage UI for better engagement and modern layouts.
- Update: Major UI/UX redesign for the Android Mobile Application for a smoother user experience.
- Ads Mediation Settings: Added configuration controls for Facebook Audience Network and AppLovin MAX ads.
- Multi-Ads Rotation Manager: Set up ad rotation ratios and priority values directly from the admin settings.
- Settings Schema Enhancements: Optimized database collections for flexible third-party plugins.
- Added AES-256-CBC token encryption for all local and cloud video streams (AWS S3, DigitalOcean, Google Cloud, Backblaze B2).
- Secured video routes to display encrypted tokens instead of raw file paths or storage hosts.
- Implemented Next.js middleware and API route guards to block direct access to video files (403 Forbidden).
- Added automatic file deletions from local/cloud storage when a Drama Series or Episode is deleted.
- Added automatic cleanup of old cover images and videos during edit updates.
- Refactored Likes, Favorites, and Share web buttons to align with the Android app UI.
- Integrated native Web Share API dialog for easy video sharing.
- Added dynamic regional extraction from B2/DO endpoints and Google Cloud defaults to prevent S3 client signature errors.
- Added client-side validation toast notices in the admin Series form for missing required fields.
- Enabled wildcard image domains in next.config.ts for all custom storage hostnames.
- New: Documentation update.
- New: Dedicated Mobile App settings section added.
- New: Android App configuration panel.
- New: API Base URL management for mobile applications.
- New: API Access Key generation and management.
- New: Mobile app version control and force update system.
- New: Custom update URL configuration.
- New: Privacy Policy, Terms of Service and Rate Us links management.
- New: Google Play Billing (Google Pay In-App Purchases) support.
- New: Enable/Disable option for Google Play payments.
- Update: Payment Gateway settings redesigned.
- New: Dedicated Android Rewards System.
- New: Separate Android Ad Rewards management.
- New: Android Daily Check-in reward configuration.
- New: Android reward task management panel.
- New: AI-powered metadata generator added.
- New: Automatic title, description, and SEO metadata generation.
- New: Automatic tags, categories, and URL slug generation.
- New: Added OpenAI support as second AI provider.
- Update: Groq Cloud integration and AI configuration panel improved.
- Update: Added PayPal, Stripe & Razorpay payment logos.
- Fix: General performance, stability, and mobile responsiveness improvements.