Quizwhiz Documentation

Overview

Quizwhiz is a dynamic and engaging quiz application designed to challenge users with a variety of topics and questions. The app features both a user-facing interface and an admin panel, ensuring a seamless and enjoyable experience for quiz participants and efficient management for administrators.

Architecture

For detailed architecture, refer to the Flutter Bloc Architecture.

App Description

Embark on an exciting journey of trivia and intellect with the Quizwhiz General Knowledge Quiz app, your ultimate destination for challenging quizzes and mind-boggling questions. Perfect for quiz enthusiasts and knowledge seekers, this app offers a plethora of quiz categories to test your knowledge on various subjects.

Immerse yourself in a world of learning and fun as you tackle questions that span history, science, literature, pop culture, and more. Put your wits to the test and compete against friends or users from around the world in multiplayer mode. With each quiz session, you’ll not only expand your knowledge but also sharpen your critical thinking skills.

Stay engaged and entertained with regular updates and new quiz challenges added to the app. Track your progress, earn rewards, and unlock achievements as you master different quiz categories. Whether you’re looking to challenge yourself or simply enjoy a fun trivia experience, Quizwhiz has something for everyone. With over 36 screens, the app ensures a comprehensive and immersive experience for all users.

User App Features

• Incorporate Advertisements – Integrate and manage ads to generate revenue from the app.
• Dynamic Quiz Topics – Keep content fresh with continuous updates and new quiz topics.
• Multimedia Quizzes – Enhance learning with videos and descriptions before presenting questions.
• Google Ads Integration – Generate revenue by implementing Google ads within quiz topics and questions.
• Timed Quizzes – Increase challenge with multiple-choice quizzes featuring a per-question timer.
• Coin Rewards – Encourage participation by rewarding users with coins for correct answers.
• Referral System – Manage coin rewards for user referrals through the admin panel.
• Earning Levels – Motivate users with a five-level earning system.
• Leaderboard – Foster competition by displaying a leaderboard of top users.
• User Profile – Allow users to edit profiles, redeem coins, and delete accounts.
• Coin Redemption – Enable users to redeem their earned coins for rewards.
• Referral Tracking – Provide a system for users to monitor their referrals and earnings.
• Earnings Overview – Let users view their total earnings from quizzes and referrals.
• Share Code – Allow users to share their referral codes with others.
• Support System – Integrate a support system to assist users with issues or queries.
• Terms and Conditions – Ensure transparency with a section for terms and conditions.
• How to Play – Offer instructions on how to play quizzes for new users.
• Push Notifications – Keep users informed and engaged with Firebase push notifications.
• Multi-Language Support – Cater to a diverse user base by offering the app in multiple languages.

Admin App Features

• Dashboard – Get a quick overview with totals of users, categories, quizzes, notifications, top users, and latest users.
• Category Management – Add, edit, delete, view, filter, and refresh categories.
• Quiz Management – Add, edit, delete, view, filter, and refresh quizzes.
• Question Management – Add, edit, delete, view, filter, and refresh quiz questions.
• Reports – View reports on user activity, earnings, redeemed points, and history with total earnings and redemptions.
• Advertisement Management – Add, edit, delete, view, filter, and refresh advertisements.
• Support Chat – Provide a chat option for user support.
• Notifications – Send notifications to users to keep them updated.
• Settings – Manage various settings, including enabling/disabling advertisements, translators, subscriptions, and payments.
• Adjustments – Configure coin values, coins per answer, coins per referral, subscription fees, quiz start timers, quiz duration timers, minimum redeemable coins, and the minimum number of quizzes to play before redeeming.

Technology Stack

State Management:

• User App: GetX
• Admin App: Flutter Bloc

Database:

• Quiz Data: Firebase Realtime Database
• Chat Functionality: Firestore

Multimedia and Ad Management:

• Google Ads for monetization

Setup Instructions

Firebase Integration

1. Firebase Project Setup
   • Go to the Firebase Console.
   • Create a new project or select an existing project.
   • Follow the prompts to set up your project.
2. Adding Firebase to Your Flutter App
   • Add the Firebase SDK to your project by following the official documentation.
   • Register your app with Firebase and download the configuration files (google-services.json for Android and GoogleService-Info.plist for iOS).
   • Place the configuration files in the appropriate directories in your Flutter project.
3. Firebase Realtime Database Setup
   • Go to the Realtime Database section in the Firebase Console.
   • Create a new database and select a location.
   • Set up database rules for read and write permissions based on your app’s requirements.
   • Integrate the Realtime Database into your Flutter app by following the FlutterFire documentation.
4. Firebase Authentication Setup
   • Go to the Authentication section in the Firebase Console.
   • Enable the sign-in methods you want to support (e.g., Email/Password, Google, Facebook).
   • Follow the FlutterFire.
   Download Quizwhiz User APK

   This comprehensive feature set ensures that Quizwhiz is not only user-friendly and engaging but also easy to manage and scale for administrators. Enjoy a seamless and dynamic quiz experience with Quizwhiz!