GameVault Pro Production Ready

GameVault Pro Setup Guide

Welcome to the official 0% to 100% comprehensive setup documentation for GameVault Pro. Follow this step-by-step guide to launch your complete gaming rewards mobile app and enterprise Laravel administration panel.

Created by: Burhan Store Version: 1.0.0 Updated: October 2026 100% Safe & Tested

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:

Project Directory Layout
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:

1

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).

2

Configure File & Directory Permissions

Ensure the storage and bootstrap/cache directories have read/write permissions for your web server process:

Terminal / SSH Command
chmod -R 775 storage bootstrap/cache
chmod -R 755 public
3

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:

.env Configuration
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.

Database Dump Location: The complete SQL file is located at admin_server/database/gamevault_pro_complete.sql.

Option A: Import via phpMyAdmin (cPanel)

  1. Log in to your cPanel and open MySQL Databases.
  2. Create a new database and a database user with All Privileges.
  3. Open phpMyAdmin and select your newly created database.
  4. Click on the Import tab at the top.
  5. Click Choose File and select gamevault_pro_complete.sql.
  6. Click Import (Go). All tables will be successfully imported in seconds.

Option B: Import via SSH / MySQL Command Line

Terminal Command
mysql -u your_db_user -p your_db_name < database/gamevault_pro_complete.sql
Default Admin Credentials:
• 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!)

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.

20 Production Games Included: The database comes pre-populated with 20 real HTML5 games across Action, Arcade, Racing, Puzzle, and Adventure categories (including Subway Surfers, Moto X3M, Stickman Hook, 2048, Temple Run 2, and Cut the Rope).

Adding a New Game in Admin Panel

  1. Navigate to Games Library > Add Game.
  2. Enter the Game Title and a short description.
  3. Select an existing Category (Action, Arcade, Racing, Puzzle, Adventure).
  4. Enter the Playable Web URL (Any responsive HTML5 game link).
  5. Set Required Play Time (e.g. 5 to 10 seconds).
  6. Set Coin Reward (e.g. 30 coins).
  7. 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:

1

Open Project in Android Studio

Launch Android Studio, click Open, and browse to select the android_code directory.

2

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.

3

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!

File to edit:
android_code/app/src/main/java/com/burhanstore/gamevault/BaseUrl.kt
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:

app/build.gradle.kts
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:

strings.xml
<resources>
    <string name="app_name">Your App Name</string>
</resources>

Step 3: Refactor Package Structure in Android Studio

  1. In the Project Tool Window, click the Gear icon (Settings) and uncheck Compact Middle Packages.
  2. Right-click on the directory folder you want to rename (e.g. burhanstore or gamevault).
  3. Select Refactor > Rename... and choose Rename Package.
  4. 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:

  1. Go to the Firebase Console and click Create a project.
  2. Click the Android icon to register an Android app.
  3. Enter your exact Package Name (e.g. com.yourcompany.yourapp).
  4. Add your development & release SHA-1 Certificate Fingerprint (Required for Google Sign-In).
  5. Download the google-services.json file.
  6. Move the downloaded google-services.json file into the android_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:

AndroidManifest.xml
<!-- 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

  1. Log in to the Admin Panel and open Ad Settings / Games Configuration.
  2. Input your Rewarded Video Unit ID and Interstitial Unit ID.
  3. Set the Double Reward Multiplier (e.g. 2x) and Daily Play Limits.
  4. Set the Ad Waterfall Priority (e.g. 1st: AdMob, 2nd: AppLovin, 3rd: Unity).
  5. 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:

1

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.

2

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.

IMPORTANT: Always back up your keystore file and passwords in a secure location! If you lose your keystore, you will not be able to push updates to existing Google Play users.
3

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

Q: Images or thumbnails are showing broken icons on the admin panel or app.
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://.
Q: Android Studio says "Could not resolve host" or network error when opening the app.
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).
Q: Google Sign-In gives "DEVELOPER_ERROR" (Status Code 10).
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.com

CodeCanyon Profile & Portfolio

Discover more premium mobile applications, scripts, and updates on our official store:

Burhan Store on CodeCanyon
Loved GameVault Pro?
If 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.