🧠 IQ Master - AI-Powered Logic & Intelligence Platform

IQ Master is an exclusive, highly interactive, and AI-driven web application designed to evaluate, analyze, and push the boundaries of your cognitive abilities. Built with a responsive, ambient-styled modern UI, the platform goes beyond traditional quizzes by offering AI-adaptive difficulty, real-time metrics, and deep post-test analytics to help you understand your logical strengths and weaknesses.

---

✨ Features

• 🔐 Secure Authentication: Seamless user login and registration using Email/Password and Google OAuth, powered by Firebase Auth.
• 🌍 Multilingual Support: Accessible to a global audience with built-in language switching (English, Spanish, French, Hindi, Marathi).
• 🌓 Light & Dark Mode: A built-in theme toggler for comfortable viewing in any lighting condition.
• 🎛 Highly Customizable Tests: Tailor your test experience before you start:
  • Difficulty Levels: Choose from Beginner, Intermediate, Advanced, or Adaptive (AI-driven difficulty scaling).
  • Question Limits: Quick sessions (10 questions), Standard (25 questions), or Full endurance (50 questions).
  • Game Modes:
    • Standard: 20 seconds per question.
    • Zen: No timer, stress-free solving.
    • Sprint: 5-minute time attack for as many questions as possible.
• 📊 Comprehensive Analytics: Upon completion, receive a simulated IQ score, explore a visual performance graph, and leverage AI to review detailed step-by-step explanations for any incorrect answers.
• 🤖 Vertex AI Integration: Seamlessly integrates @firebase/ai (powered by Google's Gemini models) to generate dynamic, adaptive questioning and provide real-time tutoring.
• 📜 Terms & Agreements Flow: Built-in modal for secure data usage agreements and simulated testing disclaimers.

---

🛠️ Tech Stack

Frontend:

• HTML5
• CSS3 (Custom Styling & Ambient Backgrounds)
• JavaScript (ES6 Modules)

Backend / Services:

• Firebase Auth: Secure Email/Password & Google OAuth (@firebase/auth).
• Firebase Realtime Database: Low-latency leaderboard and user data tracking (@firebase/database).
• Firebase Vertex AI: Advanced logic processing and adaptive prompt generation (@firebase/ai).

---

🚀 Getting Started

Prerequisites

• Node.js installed on your machine.
• A Firebase Project with the Blaze (Pay-as-you-go) Plan enabled (required for utilizing Vertex AI).

Installation

1. Clone the repository:

   git clone https://github.com/your-username/IQ-Master.git
   cd IQ-Master

2. Install dependencies:

   npm install

3. Configure Firebase & Vertex AI:

   • Go to the Firebase Console.
   • Enable Authentication (Check Google Sign-In & Email/Password providers).
   • Enable Realtime Database (Start in test mode or establish proper read/write security rules).
   • Enable Vertex AI API in the Google Cloud Console linked to your Firebase project.
   • Register your Web App in Firebase to get your config object.

   Create a script.js (or your designated Firebase initialization file) and add your credentials:

   import { initializeApp } from "firebase/app";
   
   const firebaseConfig = {
     apiKey: "YOUR_API_KEY",
     authDomain: "YOUR_AUTH_DOMAIN",
     databaseURL: "YOUR_DATABASE_URL",
     projectId: "YOUR_PROJECT_ID",
     storageBucket: "YOUR_STORAGE_BUCKET",
     messagingSenderId: "YOUR_MESSAGING_SENDER_ID",
     appId: "YOUR_APP_ID"
   };
   
   export const app = initializeApp(firebaseConfig);

4. Run the Application: You can serve the application using any local development server, such as Live Server (VS Code) or an npm package like http-server:

   npx http-server .

   Open http://localhost:8080 in your browser.

---

🎮 How to Play

1. Sign In: Create a secure account or bypass the signup process using Google OAuth.
2. Accept Terms: Review the data and testing agreements presented on login.
3. Customize Parameters: Select your difficulty, target category, question limit, and temporal game mode.
4. Engage: Solve logic puzzles before the timer runs out (Standard/Sprint) or at your own pace (Zen).
5. Analyze: Receive your simulated IQ score, visualize your speed/accuracy, and learn from AI explanations.

---

👨‍💻 Engineering Team

Proudly architected and developed by:

• Ananya Parbat - LinkedIn Profile
• Atharv Bowlekar - LinkedIn Profile