Welcome to QuizVerse Documentation

Upload the contents of admin-panel/ to your server directory (e.g., /public_html/admin/).
CRITICAL: In cPanel Domains / Subdomains manager, set your Document Root to point to admin-panel/public.

Open https://your-domain.com/install in your browser. The wizard automatically checks your server for PHP 8.3+ and required PHP extensions, as well as write permissions for storage/ and bootstrap/cache/.

Enter your cPanel MySQL Database credentials (Database Host, Database Port, Database Name, Username, and Password):

Click Test & Setup Database. The wizard will automatically connect to your database and begin creating all required tables:

Once table creation completes, the wizard automatically populates default application configurations, system permissions, and initial sample data into your database:

Fill out the Super Admin setup form with your preferred Name, Email Address, and Password. This will become your primary administrator login.

Enter your Envato Purchase Code and Envato Username. Click Verify & Activate License.

Click Launch Admin Panel to sign in to your live administration interface at https://your-domain.com/admin/login!

Open quizverse-app-v1.0.3/ in Android Studio or VS Code. Run:

flutter pub get

Open lib/config/app_config.dart and set defaultBaseUrl to your live backend domain:

class AppConfig {
  static const String appName = 'QuizVerse';
  static const String apiVersion = 'v1';
  
  // REPLACE WITH YOUR LIVE API URL
  static const String defaultBaseUrl = 'https://admin.yourdomain.com/api/v1';

  static String baseUrl = defaultBaseUrl;
}

1. Go to Firebase Console ➔ Create a project named QuizVerse.
2. Add Android App with your package ID ➔ Download google-services.json ➔ Save to quizverse-app-v1.0.3/android/app/google-services.json.
3. Add iOS App with your bundle ID ➔ Download GoogleService-Info.plist ➔ Save to quizverse-app-v1.0.3/ios/Runner/GoogleService-Info.plist.
4. Enable Authentication providers (Google, Phone, Apple, Email) in Firebase.
5. In Firebase Console ➔ Project Settings ➔ Service Accounts, generate a private key JSON and upload it to your Admin Panel under Settings ➔ Firebase Settings for push notifications.

To update the visible app title displayed on smartphone home screens:

• Android: Open android/app/src/main/AndroidManifest.xml and update android:label="QuizVerse" to android:label="Your App Name".

• iOS: Open ios/Runner/Info.plist and update both CFBundleDisplayName and CFBundleName string values to Your App Name.

• In-App Config: Open lib/config/app_config.dart and set static const String appName = 'Your App Name';.

To update the app launcher icon and in-app brand logos, replace the logo assets at the following project locations:

• App Launcher Icon: Replace assets/images/app_launcher_logo/app_launcher_icon.png with your custom logo (recommended 1024×1024 px PNG format).
• In-App Dark Theme Logo: Replace assets/images/app_logos/quizverse_dark.png.
• In-App Light Theme Logo: Replace assets/images/app_logos/quizverse_light.png.

Run the automated launcher icon generator commands below to update native Android ic_launcher & iOS app icons:

# 1. Add the flutter_launcher_icons package
flutter pub add --dev flutter_launcher_icons

# 2. Automatically generate native Android & iOS launcher icons (ic_launcher)
dart run flutter_launcher_icons

QuizVerse supports full Android 12+ Splash Screen API (generated in android/app/src/main/res/drawable-*/android12splash.png) and iOS native launch screens. To automatically generate and update native splash screen assets across all screen density folders (hdpi, mdpi, xhdpi, xxhdpi, xxxhdpi, and night mode):

1. Ensure your splash icon asset is placed at assets/images/app_launcher_logo/app_launcher_icon.png.
2. Run the automated native splash generator commands below:

# 1. Add the flutter_native_splash package
flutter pub add --dev flutter_native_splash

# 2. Auto-generate Android 12+ & iOS native splash screens
dart run flutter_native_splash:create

Run the commands below to update your Android Package ID & iOS Bundle Identifier globally (e.g. com.yourcompany.quizverse):

# 1. Add the change_app_package_name dev dependency
flutter pub add --dev change_app_package_name

# 2. Run package rename utility for Android & iOS
dart run change_app_package_name:main com.yourcompany.quizverse

Manual Package Rename (Alternative):

• Android: Update applicationId in android/app/build.gradle and namespace in android/app/src/main/AndroidManifest.xml.
• iOS: Open ios/Runner.xcworkspace in Xcode ➔ Select Runner target ➔ Update Bundle Identifier under Signing & Capabilities.

Run the keytool command in your terminal to generate your production release keystore file at android/app/my-release-key.jks:

# Generate new release keystore (save to android/app/my-release-key.jks)
keytool -genkey -v -keystore android/app/my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload

Create a file named key.properties inside the android/ directory and populate it with your keystore credentials:

storePassword=your_password
keyPassword=your_password
keyAlias=your_alias_name
storeFile=my-release-key.jks

Compile production release binaries for Google Play Store (.aab / .apk) and Apple App Store (.ipa):

# Build Android App Bundle (.aab) for Google Play Store submission
flutter build appbundle --release

# Build universal release APK
flutter build apk --release

# Build iOS Release Package (.ipa)
flutter build ipa --release

Go to your cPanel ➔ phpMyAdmin ➔ Select your QuizVerse database ➔ Click Export. Also download a zip copy of your admin-panel directory.

Ensure your server Cron Job is active so background migrations and queue drivers execute smoothly during update deployment.

1. Log in to your QuizVerse Admin Panel as Super Admin.
2. In the left sidebar, navigate to System Update.
3. Under Select Update Package (.ZIP File), click Choose File and select your official update file (e.g. update-version-latest.zip).
4. Click Upload & Apply System Update.

The update engine automatically extracts the update archive, runs database schema migrations, updates version tags, and clears route & application caches. Once complete, your Admin Panel will display the updated version badge!