GuardianX VPN is a production-ready Android VPN template based on Shadowsocks. It fetches servers dynamically from an external JSON file, features a clean server picker, connection stats, and a modern UI. Perfect for quick rebranding and monetization with AdMob (Banner, Interstitial, Rewarded).

What you get:

• Dynamic servers from a hosted JSON (GitHub raw or your hosting)
• Server picker with search and country flags
• Connection stats: duration and data usage
• AdMob integration: banner, interstitial, rewarded (with rewarded-time credit)
• Cached servers for offline fallback
• Clean architecture in Kotlin + detailed HTML documentation

Rebrand in minutes:

• Change package name and app name
• Replace icons and strings
• Update your server JSON URL and AdMob IDs
• Build and publish

Features

• Dynamic servers (JSON)
• Server search and country flags
• Connect/Disconnect with status
• Rewarded ads grant extra VPN time
• Banner and interstitial ads integrated
• Offline cache of last fetched servers
• Modern UI with material components
• Clean Kotlin codebase

Requirements

• Android Studio (latest stable)
• Kotlin/SDK (bundled with Android Studio)
• AdMob account (for production ad units)
• A hosted JSON file for servers (GitHub raw or your hosting)

Instructions

1. Open in Android Studio, wait for Gradle sync.
2. Refactor package name from 

   com.developerrajnagor.maniavpnmm
   
   
   
   

    to yours (Refactor > Rename).
3. Change app name in 

   res/values/strings.xml
   
   
   
   

    and app icons in 

   res/mipmap-*/
   
   
   
   

   .
4. Replace the server JSON URL with your own “raw” URL in:
   • ServersActivity.kt,  SplashActivity.kt,  MainActivity.kt (if present).
5. Replace AdMob IDs in  strings.xml and ensure 

   <meta-data>
   
   
   
   

    in  AndroidManifest.xml.
6. Build and run.

Demo/Preview (optional)

• If you have a live privacy/help page, include links (the project references):
  • Help: https://qatarvpn.github.io/adsme/help.html
  • Privacy: https://qatarvpn.github.io/adsme/myprv.html
• Replace with your own URLs before publishing.

Changelog (example)

• v1.0.0 (Initial)
  • First public release: dynamic servers (JSON), AdMob (banner/interstitial/rewarded), server search, cached servers, documentation (AR/EN).