This application is a fully-featured, AI-supported quiz and trivia platform designed to offer users an engaging, competitive, and rewarding knowledge experience.

Users can participate in:

• ⚔️ Real-time online duels
• 🧩 Offline single-player quiz modes
• 🎯 Task and mission-based challenges
• 🏆 Competitive ranking and leaderboard systems

Users earn points by answering questions correctly and completing tasks. Earned points can be used to:

• 💸 Request payouts
• 🛒 Purchase digital products from the in-app market

The application combines learning, entertainment, competition, and monetization into one scalable mobile solution.

Demo Apk Link: https://drive.google.com/file/...

admin panel:

e-posta: [email protected]

password: 121212

🌐 Multi-Language Support (14 Languages)

English, Spanish, Turkish, Indonesian, Portuguese, German, French, Polish, Arabic, Russian, Chinese, Albanian, Filipino, Hindi

🎮 Game Modes

• Online Real-Time Duels
  • Random category & question selection
  • Live 1v1 matchmaking
• Offline Single Player Mode
  • Users select categories and solve random quizzes

📊 User Statistics (Shown to Opponents)

• Total games played
• Total games won
• Win rate
• Game abandonment rate

👥 Friend System

• Add friends and send friend requests
• Instant notifications for friend requests
• Invite friends even when they are offline
• View online/offline status
• Challenge friends to duels anytime

🏆 Ranking & Avatar System

• Global leaderboard based on points
• Profile avatar selection
• Avatars visible in online matches and rankings

🤖 AI-Powered Question Management (Admin Panel)

• Generate questions using AI
• Create questions by entering topics or categories
• Upload PDF files and auto-generate related questions
• Manual question creation & editing
• Category and test management
• Optional image support for questions (manual)
• Questions become instantly available to users

🔗 Referral System

• Register using referral codes
• Both inviter and invited user receive 500 points
• Automatic notification system

🎭 Dynamic Avatar Management

• Add new avatars from admin panel
• No app update required
• Dynamic avatar expansion

🔔 Notification System

• Send notifications to:
  • Specific users
  • User groups
  • All users
• Payment approval notifications include payout amount

🛒 Market Management

• Add digital products via admin panel
• Set product point values
• Define purchase/request limits

⚖️ Dynamic Scoring System

• Fully customizable scoring
• Example: 100 points per question

💸 Payment System & Limiters

• Users can request payouts
• Monthly payout request limit
• Adjustable minimum payout points
• Custom point-to-dollar ratio (Example: 5000 points = 1 Dollar)

🎯 Task & Mission System

Create tasks for categories or platforms

Instant task notifications

Example: “Leave a review” task with reward points

Task quotas (limited users)

Screenshot proof upload

Admin approval system:

Approved → points added automatically

Rejected → retry allowed

📈 Admin Dashboard Statistics

<

Flutter SDK 3.22+
Android Studio (or VS Code) with Android SDK installed
Firebase account with a project on Blaze plan
Firebase services enabled: Authentication, Cloud Firestore, Cloud Storage, Cloud Functions, Cloud Messaging
Node.js 22+ installed (for Firebase Cloud Functions)
A valid Gemini API key from Google AI Studio
Android 8.0 (API 26) or higher device/emulator

Download and extract the project ZIP.

Open the project root folder in Android Studio (the folder with pubspec.yaml).

Run flutter pub get in the terminal.

Create a new Firebase project on Blaze plan and add an Android app with your own package name.

Download google-services.json from Firebase and place it in android/app/google-services.json.

Generate firebase_options.dart with flutterfire configure or update it manually with your Firebase keys.

Enable Authentication, Firestore, Storage, Functions and Messaging in Firebase.

Deploy Cloud Functions from the functions folder using firebase deploy --only functions or npm run deploy.

Get a Gemini API key and paste it into lib/admin/pdf_question_generator_screen.dart where Your Gemini Api is.

Change the app name and package name to your own brand.

Run the app on an emulator or device with flutter run and create missing Firestore indexes via the Firebase console links.