BankQuant Zero

BankQuant Zero is a gamified learning platform designed to help aspiring bankers master quantitative aptitude for banking exams. Test your skills, track your progress, and level up your knowledge with AI-powered drills and exams.

✨ Features

• User Authentication: Secure login and signup system powered by Firebase.
• Interactive Drills: Practice core concepts like multiplication, squares, cubes, fractions, percentages, and simplification (BODMAS).
• Exam Mode: Test your knowledge with AI-generated, exam-level questions tailored to specific banking exams.
• AI-Powered Explanations: Get instant, step-by-step explanations for incorrect answers in Exam Mode.
• Personalized Dashboard: Track your progress with metrics on mastered concepts and view your weekly activity.
• Gamified Progression: Master drill ranges by completing them multiple times to unlock new sets of questions. Your progress, including XP and level, is tracked on your dashboard.
• Customizable Experience: Adjust themes, accent colors, and drill settings like imprint delay and mastery repetitions.
• Responsive Design: Seamless experience on desktop, tablet, and mobile devices.

🚀 Getting Started

Prerequisites

• Node.js (v18 or later recommended)
• npm or a compatible package manager
• A Firebase project.

1. Clone the repository

If you are running this in a development environment like Firebase Studio, you can skip this step.

2. Install dependencies

npm install

3. Set up environment variables

The application uses Genkit with Google AI for its AI features and Firebase for authentication. You will need to configure keys for both.

1. Create a .env.local file in the root of the project. You can copy the contents from the .env file to start.
2. Google AI (Gemini) Setup:
   • Get your API key from Google AI Studio.
   • Add your key to .env.local: GEMINI_API_KEY="YOUR_API_KEY_HERE"
3. Firebase Setup:
   • Go to the Firebase Console and create a new project. You can also add Firebase to an existing Google Cloud project if you've reached your project quota.
   • In your project, go to Project Settings > General.
   • Register a new web app. You don't need to add the SDK scripts, just copy the firebaseConfig object values.
   • In your project, go to the Authentication section, click "Get started", and enable the Email/Password provider.
   • Add the Firebase config values to your .env.local file:

   NEXT_PUBLIC_FIREBASE_API_KEY="your-api-key"
   NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN="your-auth-domain"
   NEXT_PUBLIC_FIREBASE_PROJECT_ID="your-project-id"
   NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET="your-storage-bucket"
   NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID="your-messaging-sender-id"
   NEXT_PUBLIC_FIREBASE_APP_ID="your-app-id"
   

4. Run the development server

npm run dev

The application will be available at http://localhost:9002.

If you haven't configured your Firebase credentials, the app will display a guide on how to do so.

🛠️ Tech Stack

• Framework: Next.js (App Router)
• Authentication: Firebase Authentication
• AI: Google AI (Gemini) via Genkit
• UI: React, ShadCN UI, Tailwind CSS
• Charts: Recharts
• Animations: Framer Motion

## 📄 License

This project is licensed under the MIT License.

Created By Raj Kashyap - 2026.