1. Overview & Key Features
GameVault Pro is an end-to-end modern gaming rewards platform designed for high user engagement, retention, and maximum ad monetization. The system consists of a native Android application built with Kotlin & Jetpack Compose and an enterprise Laravel 12 administrator panel.
20+ Instant HTML5 Games
Preloaded with 20 iconic games across 5 categories with custom play timers and coin reward verification.
Ad Waterfall Monetization
Integrated with Google AdMob, AppLovin, and Unity Ads with multi-tier rewarded video fallback logic.
Refer & Earn Program
Complete viral referral system featuring unique invitation codes, dynamic deep links, and milestone rewards.
7-Day Daily Streaks
Progressive check-in rewards that encourage daily active usage and build strong app retention habits.
Multi-Currency Wallet
Coins & Gems balance system with support for PayPal, Bank Transfer, Crypto, Bkash, Nagad & Gift Cards.
Anti-Fraud & Cheat Guard
Server-side session verification, elapsed play duration checks, device throttling, and duplicate IP protection.
2. Architecture & Technology Stack
GameVault Pro is developed using clean, modern industry standards with separation of concerns between backend API operations and high-performance client rendering:
| Component | Technology | Details |
|---|---|---|
| Mobile App | Native Kotlin & Jetpack Compose | Material 3 design system, Light White UI, Kotlin Coroutines, Retrofit 2 & OkHttp, Navigation Compose |
| Backend API | Laravel 12 / PHP 8.2+ | RESTful JSON API with Laravel Sanctum token authentication, rate limiting, and request validation |
| Admin Console | Blade & Tailwind CSS | Interactive dashboard with responsive sidebar, dynamic charts, modals, and rich data tables |
| Database | MySQL 5.7+ / MariaDB 10.3+ | Normalized relational schema with 51 tables, foreign key constraints, and indexed lookups |
3. Server & System Requirements
Before installing the backend and building the Android application, make sure your hosting and development environment meet the following specifications:
Server Requirements (Hosting / VPS / cPanel)
| Requirement | Minimum | Recommended |
|---|---|---|
| PHP Version | PHP 8.2 | PHP 8.2.x or PHP 8.3 / 8.4 |
| Database | MySQL 5.7+ or MariaDB 10.3+ | MariaDB 10.6+ / MySQL 8.0+ |
| Web Server | Apache with mod_rewrite | LiteSpeed Web Server or Nginx |
| PHP Extensions | BCMath, Ctype, cURL, DOM, Fileinfo, JSON, Mbstring, OpenSSL, PDO, PDO_MySQL, Tokenizer, XML, Zip |
|
| SSL Certificate | Valid HTTPS certificate (Let's Encrypt / cPanel AutoSSL is supported) | |
Android Development Environment
- Android Studio: Hedgehog (2023.1.1), Iguana, Jellyfish, Koala, Ladybug (2024.2+) or later
- JDK: Java Development Kit (JDK) 17 (Embedded with Android Studio)
- Android SDK: Target SDK 34 / 35 (Android 14 / 15) with Minimum SDK 24 (Android 7.0)
4. Package Contents & Directory Layout
When you extract your CodeCanyon download zip, you will find the following clean structure:
gamevault_pro/
├── admin_server/ # Laravel 12 Admin Panel & Backend API
│ ├── app/ # Controllers, Models, Middleware, Helpers
│ ├── database/
│ │ └── gamevault_pro_complete.sql # Full complete SQL database dump
│ ├── public/ # Web root (index.php, storage symlink, assets)
│ ├── resources/views/admin/ # Admin Dashboard Blade views
│ ├── routes/ # web.php & api.php routes
│ └── .env.example # Environment configuration template
├── android_code/ # Complete Native Android Studio Project
│ ├── app/
│ │ ├── src/main/java/com/burhanstore/gamevault/ # Jetpack Compose UI & Logic
│ │ │ ├── BaseUrl.kt # Single-line API endpoint configuration
│ │ │ ├── presentation/ # Compose UI Screens & Navigation
│ │ │ └── data/ # Models, Repositories, SessionManager
│ │ └── build.gradle.kts # App build script & dependency versions
│ └── build.gradle.kts # Root Gradle build script
└── documentation/ # Offline Buyer Setup Documentation (This Guide)
├── index.html
└── assets/
5. Admin Panel Installation (cPanel & VPS)
Follow these steps to deploy the Laravel backend application on your hosting server:
Upload the Admin Server Files
Upload the contents of the admin_server directory to your server (e.g. into your subdomain directory /home/username/gamevault.yourdomain.com or public_html).
Configure File & Directory Permissions
Ensure the storage and bootstrap/cache directories have read/write permissions for your web server process:
chmod -R 775 storage bootstrap/cache
chmod -R 755 public
Set Up Environment File (.env)
In the root of your admin server, rename .env.example to .env (or create a new .env file) and set your live URL and database credentials:
APP_NAME="GameVault Pro"
APP_ENV=production
APP_KEY=base64:xK7vB... # Generated via php artisan key:generate
APP_DEBUG=false
APP_URL=https://gamevault.yourdomain.com
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_database_user
DB_PASSWORD=your_database_password
SANCTUM_STATEFUL_DOMAINS=gamevault.yourdomain.com
SESSION_DRIVER=file
FILESYSTEM_DISK=public
6. Database Setup & SQL Import
GameVault Pro comes with a pre-configured database dump containing all 51 tables, settings, sample banners, withdrawal methods, and 20 verified playable games.
admin_server/database/gamevault_pro_complete.sql.
Option A: Import via phpMyAdmin (cPanel)
- Log in to your cPanel and open MySQL Databases.
- Create a new database and a database user with All Privileges.
- Open phpMyAdmin and select your newly created database.
- Click on the Import tab at the top.
- Click Choose File and select
gamevault_pro_complete.sql. - Click Import (Go). All tables will be successfully imported in seconds.
Option B: Import via SSH / MySQL Command Line
mysql -u your_db_user -p your_db_name < database/gamevault_pro_complete.sql
• Login URL:
https://yourdomain.com/admin/login• Email:
proadmin@gmail.com• Password:
admin123456(Make sure to change your password immediately inside the Admin Profile screen after logging in!)
7. Storage Symlink & .htaccess Setup
To ensure that all uploaded banner images, game thumbnails, and payment gateway icons load directly in web browsers and the mobile app without broken links, follow these two critical configuration steps:
Step 1: Create the Storage Symlink
Run the artisan storage link command in your project directory via SSH, or create the symlink via cPanel Terminal:
php artisan storage:link
This creates a symbolic link from public/storage pointing to storage/app/public.
Step 2: Clean URL Rewriting (.htaccess)
If you are deploying on a cPanel subdomain where the document root points to the project root (rather than the public/ subfolder), place this battle-tested .htaccess file in your project root directory:
<IfModule mod_rewrite.c>
<IfModule mod_negotiation.c>
Options -MultiViews -Indexes
</IfModule>
Options +FollowSymLinks
RewriteEngine On
# Handle Authorization Header
RewriteCond %{HTTP:Authorization} .
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
# Handle X-XSRF-Token Header
RewriteCond %{HTTP:x-xsrf-token} .
RewriteRule .* - [E=HTTP_X_XSRF_TOKEN:%{HTTP:X-XSRF-Token}]
# Strip /public/ from URLs to keep links clean
RewriteCond %{THE_REQUEST} \s/public/(.*?)\s [NC]
RewriteRule ^ %1 [L,NE,R=301]
# Rewrite all traffic into public/ directory
RewriteCond %{REQUEST_URI} !^/public/
RewriteRule ^(.*)$ public/$1 [L,QSA]
</IfModule>
# Protect sensitive environment and package files
<FilesMatch "^(\.env|\.git|composer\.(json|lock)|package\.(json|lock))">
Order allow,deny
Deny from all
</FilesMatch>
8. Admin Control Center Walkthrough
The GameVault Pro admin console gives you 100% control over all user activities, monetization parameters, and app content from a single dashboard:
Users & Access
View registered users, total coin & gem balances, ban/unban status, and search users by name or email.
Home Banners
Create and update animated carousel banners with custom click actions (External URLs or In-App routes).
Games Management
Manage the game library, set wait time play duration (5s–60s), adjust win rewards, and feature top games.
Withdrawal Requests
Approve or reject pending cashout requests with custom transaction notes and automated user balance deductions.
9. In-App Games & Reward System
GameVault Pro features an intelligent game session tracking architecture. When users launch a game in the app, a timer monitors their gameplay. Once they satisfy the required play duration (e.g. 5 to 10 seconds), they earn coins and can watch an ad to double their reward.
Adding a New Game in Admin Panel
- Navigate to Games Library > Add Game.
- Enter the Game Title and a short description.
- Select an existing Category (Action, Arcade, Racing, Puzzle, Adventure).
- Enter the Playable Web URL (Any responsive HTML5 game link).
- Set Required Play Time (e.g.
5to10seconds). - Set Coin Reward (e.g.
30coins). - Upload a high-quality square thumbnail image and click Save Game.
10. Withdrawal Payment Gateways
Configure which payout methods are available to users. You can enable, disable, and customize minimum cashout thresholds:
| Method | Supported Types | User Input Prompt |
|---|---|---|
| PayPal | USD, EUR, GBP | PayPal Account Email Address |
| Cryptocurrency | USDT (TRC20 / BEP20), Bitcoin, LTC | Wallet Address & Network |
| Gift Cards | Google Play, Amazon, Steam, PlayStation | Delivery Email Address |
| Local Mobile Wallets | Bkash, Nagad, Paytm, UPI, JazzCash | Registered Mobile Number / UPI ID |
11. Android Studio Setup & Environment
Follow these steps to open and configure the mobile app in Android Studio:
Open Project in Android Studio
Launch Android Studio, click Open, and browse to select the android_code directory.
Gradle Sync & Dependencies
Android Studio will automatically detect the Gradle files and download all necessary libraries. Wait for the Gradle sync to finish with BUILD SUCCESSFUL.
Verify JDK 17 Configuration
Go to Settings / Preferences > Build, Execution, Deployment > Build Tools > Gradle and ensure that the Gradle JDK is set to Embedded JDK 17.
12. Connect Android App to Your Backend
Connecting the Android app to your live admin panel requires changing only one single line of code in the entire project!
android_code/app/src/main/java/com/burhanstore/gamevault/BaseUrl.kt
package com.burhanstore.gamevault
object BaseUrl {
/**
* Set your live admin panel URL here (without trailing slash or "/api")
*/
const val BASE_URL = "https://gamevault.yourdomain.com"
}
Simply replace https://gamevault.yourdomain.com with your actual backend URL. The app will immediately route all API authentication, game sessions, streaks, and wallet balance requests to your server.
13. Rebranding & Package Name Refactoring
To publish your app on the Google Play Store, you must change the Package Name (Application ID) and App Name to your own brand:
Step 1: Change Application ID
Open app/build.gradle.kts and locate the defaultConfig block:
defaultConfig {
applicationId = "com.yourcompany.yourapp" // Replace with your unique package name
minSdk = 24
targetSdk = 35
versionCode = 1
versionName = "1.0.0"
}
Step 2: Change App Name
Open app/src/main/res/values/strings.xml and update the application label:
<resources>
<string name="app_name">Your App Name</string>
</resources>
Step 3: Refactor Package Structure in Android Studio
- In the Project Tool Window, click the Gear icon (Settings) and uncheck Compact Middle Packages.
- Right-click on the directory folder you want to rename (e.g.
burhanstoreorgamevault). - Select Refactor > Rename... and choose Rename Package.
- Enter your new package segment name and click Refactor, then click Do Refactor.
14. Firebase Setup (google-services.json)
Firebase powers Cloud Messaging (push notifications) and Google Sign-In:
- Go to the Firebase Console and click Create a project.
- Click the Android icon to register an Android app.
- Enter your exact Package Name (e.g.
com.yourcompany.yourapp). - Add your development & release SHA-1 Certificate Fingerprint (Required for Google Sign-In).
- Download the
google-services.jsonfile. - Move the downloaded
google-services.jsonfile into theandroid_code/app/directory.
15. Ad Networks Setup (AdMob, AppLovin, Unity)
GameVault Pro features dynamic ad network waterfall management. You can configure AdMob App IDs and switch ad network priorities directly from the admin panel without rebuilding the app!
Configuring AdMob in AndroidManifest.xml
Open app/src/main/AndroidManifest.xml and update your Google AdMob App ID:
<!-- Replace with your live Google AdMob App ID -->
<meta-data
android:name="com.google.android.gms.ads.APPLICATION_ID"
android:value="ca-app-pub-XXXXXXXXXXXXXXXX~XXXXXXXXXX" />
Configuring Ad Unit IDs in Admin Panel
- Log in to the Admin Panel and open Ad Settings / Games Configuration.
- Input your Rewarded Video Unit ID and Interstitial Unit ID.
- Set the Double Reward Multiplier (e.g.
2x) and Daily Play Limits. - Set the Ad Waterfall Priority (e.g. 1st: AdMob, 2nd: AppLovin, 3rd: Unity).
- Click Save Ad Settings. The changes take effect dynamically on the app.
16. Building Signed APK & Google Play AAB
When you are ready to publish your application to Google Play or distribute a release APK:
Generate a Signed Key (Keystore)
In Android Studio, go to Build > Generate Signed Bundle / APK...
Select Android App Bundle (.aab) for Google Play Store upload, or APK for direct testing. Click Next.
Create New Key Store
Click Create new..., specify a secure path on your computer (e.g. gamevault_release.jks), enter a strong password, fill in your developer details, and click OK.
Select Release Variant
Select the release build variant, check V1 and V2 (Full APK Signature), and click Finish.
Your signed production AAB/APK will be generated in app/release/app-release.aab.
17. Troubleshooting & Frequently Asked Questions
Solution:
1. Make sure you ran
php artisan storage:link.2. Verify that
public/storage exists as a valid symbolic link.3. Verify that your root
.htaccess contains RewriteRule ^(.*)$ public/$1 [L,QSA] (with the $1 parameter).4. Verify that
APP_URL in your .env file matches your exact domain with https://.
Solution: Ensure your mobile device or emulator has an active internet connection, and verify that
BaseUrl.BASE_URL in BaseUrl.kt contains your live accessible domain (e.g. https://gamevault.yourdomain.com).
Solution: This happens when the SHA-1 fingerprint of your debug or release keystore has not been added to your Firebase project settings. Run
./gradlew signingReport in Android Studio, copy your SHA-1 key, paste it into Firebase Console > Project Settings > Your Apps, and re-download google-services.json.
18. Customer Support & Author Contact
Thank you for choosing GameVault Pro by Burhan Store! We are committed to providing top-quality software and prompt developer support.
Direct Support Email
For bug reports, technical inquiries, or customization requests, email our dedicated support desk:
10mbblog@gmail.comCodeCanyon Profile & Portfolio
Discover more premium mobile applications, scripts, and updates on our official store:
Burhan Store on CodeCanyonIf this project helps your business, please take a moment to leave a 5-Star Rating on CodeCanyon! Your feedback helps us continue releasing new features and regular updates.