🧠 QuizNest – AI Quiz App

🚀 Quick Start

Start both servers automatically:

npm run dev

Or use the shell script:

./start.sh

For more options, see START_GUIDE.md

Adaptive difficulty (confidence, modes, blending): docs/ADAPTIVE_DIFFICULTY_AND_CONFIDENCE.md

🌐 Live Demo -->> Click Here

Achievement System ✅
- Earn badges like "Quiz Master," "Speed Genius," and "Perfect Score"
- View badges and stats in enhanced user profile
- Achievem## 🔄 Future Enhancements
🔮 Advanced AI Tutoring: Enhanced conversation memory and learning path optimization
🌐 Social Learning Groups: Real-time collaborative study sessions
📊 Advanced Analytics: Machine learning-powered performance predictions
🎮 Tournament Brackets: March Madness-style competitive tournaments
📱 Native Mobile Apps: iOS and Android app store releases
🔗 Learning Management Integration: Canvas, Blackboard, Moodle compatibility
🎯 Skill-Based Matching: AI-powered opponent matching for fair competitions
🏆 NFT Achievements: Blockchain-based certificate system
⚡ Further Performance Optimizations: WebAssembly integration for complex calculations
🎨 Advanced Animation Engine: Custom animation library optimized for quiz interfaces

💬 Latest Updates & News

🚀 September 2025 - Major UI/UX Overhaul & Smart Features Update

🎮 Smart Quiz Experience (NEW)

Intelligent Fullscreen Mode: Auto-submit protection when interrupted (Escape key, route changes, browser close)
Performance-Optimized UI: Lightning-fast rendering with smooth animations
Mobile-First Design: Perfect responsive experience across all devices
Enhanced Timer: Centered, non-intrusive timing system

📊 Advanced Analytics & Reports (NEW)

Beautiful User Reports: Modern card layouts replacing clunky tables on mobile
Real-Time Performance Tracking: Live progress updates and achievements
Comprehensive Analytics: Category-wise performance breakdown
Visual Progress Indicators: Interactive charts for better understanding

🎨 World-Class UI/UX Overhaul (NEW)

Glassmorphism Design: Modern, elegant interface with transparency effects
Responsive Mobile Experience: Cards replace tables for better usability
Smooth Animations: Framer Motion-powered micro-interactions
Theme Customization: Light, dark, and custom themes

📚 Comprehensive Help System (NEW)

Interactive Help Guide: Step-by-step tutorials for every feature
User Type Explanations: Clear differences between Simple, Premium, and Admin users
Quiz Creation Tutorials: Complete guide for premium users
Troubleshooting Section: Solutions for common issues

🛡️ Exceptional Features (NEW)

Auto-Submit Protection: Never lose progress due to interruptions
PWA Optimization: Install as native app experience
Cross-Platform Compatibility: Flawless on all devices and browsers
Smart State Management: Efficient data handling with React best practices

🚀 July 2025 - Major Feature Release & Performance Update

🤖 AI Study Buddy (NEW)

Revolutionary Google Gemini 2.5 Pro integration
Personalized tutoring with conversation memory
Dynamic quiz generation from AI conversations
Smart explanations adapted to your learning style

⚔️ Real-Time Quiz Battles (NEW)

Live multiplayer competitions with instant scoring
Speed bonuses and real-time leaderboards
In-game chat and synchronized timers
Customizable room settings and host controls

📱 Progressive Web App (NEW)

Install QuizNest as a native app
Offline functionality with smart caching
Push notifications for study reminders
Background data synchronization

🎨 Next-Gen UI/UX & Performance Optimization

Complete design system overhaul with optimized animations
15+ advanced theme options with smooth transitions
Mobile-first responsive design with 60fps performance
Enhanced accessibility features
Performance Boost: Optimized CSS animations and reduced backdrop-filter effects for smoother frame rates
Animation Optimization: Simplified framer-motion animations to eliminate frame-by-frame lag
Hardware Acceleration: Implemented CSS transforms and will-change properties for better performance

Daily Challenges ✅
- Fresh daily quiz challenges with special rewards
- Progress tracking and completion status
- XP and points system for engagement
- Reset timer for next day's challenges
Tournament System ✅
- Create and participate in quiz tournaments
- Registration-based competitive gameplay
- Prize distribution for top performers
- Real-time tournament leaderboards and rankings
Enhanced Leaderboards ✅
- Weekly and monthly top scorers
- Tournament-specific rankings
- Multiplayer battle statistics
- Promotes user engagement and competitiont the live site](https://quiz-app-cp2h.onrender.com/)

🚀 Features

🔐 Authentication

Google OAuth & JWT-based secure login
Role-based access (User, Premium, Admin)

🧠 AI-Powered Quiz Generation

Automatically generate MCQs & written questions
AI assigns duration, marks, and evaluates written answers using NLP
Adaptive difficulty: beginners get easier questions, advanced users get harder ones

🎮 Smart Quiz Experience ✅

Intelligent Fullscreen Mode: Auto-submit protection when interrupted (Escape key, route changes, browser close)
Performance-Optimized UI: Lightning-fast rendering with smooth animations
Mobile-First Design: Perfect responsive experience across all devices
Enhanced Timer: Centered, non-intrusive timing system
Smart State Management: Efficient data handling with React best practices

🤖 AI Study Buddy (NEW - Premium Feature) ✅

Google Gemini 2.5 Pro Integration: Advanced AI tutoring with personalized responses
Persistent Study Sessions: Context-aware conversations that remember your learning history
Dynamic Quiz Generation: Create custom quizzes directly from AI conversations
Smart Explanations: Get detailed concept explanations adapted to your learning style
Personalized Study Plans: AI-generated learning schedules and improvement goals
Weak Area Analysis: Targeted suggestions for skill improvement
Quick Actions: Pre-defined study actions for common learning tasks
Seamless Navigation: Direct integration with existing quiz system

⚔️ Real-Time Quiz Battles (NEW - Live Multiplayer) ✅

Live 1v1 Quiz Duels: Challenge other users in real-time quiz competitions
Speed Scoring System: First to answer correctly gets maximum points with time bonuses
Real-Time Leaderboards: Dynamic rankings that update instantly during gameplay
Room Management: Create, join, and manage multiplayer quiz rooms
Live Chat System: Real-time messaging during quiz battles
Synchronized Timers: Perfect countdown synchronization across all players
Instant Results: Immediate feedback after each question with live scoring
Host Controls: Room creators can customize settings and manage gameplay
Multiplayer Statistics: Dedicated stats tracking for competitive gameplay

📱 Progressive Web App (PWA) (NEW) ✅

Native App Experience: Install QuizNest as a native app on any device
Offline Functionality: Continue learning even without internet connection
Push Notifications: Study reminders and achievement notifications
Background Sync: Automatic data synchronization when connection restored
Service Worker Caching: Lightning-fast loading with smart caching strategies
Cross-Platform: Works seamlessly on mobile, tablet, and desktop

🤖 Intelligence Dashboard (Premium Feature) ✅

Smart Quiz Recommendations: AI-powered quiz suggestions based on performance, favorite categories, and learning patterns
Adaptive Difficulty System: Dynamic difficulty adjustment based on recent performance with confidence scoring
Learning Analytics: Comprehensive performance insights with trends, predictions, and personalized study recommendations
Performance Trends: Visual weekly performance tracking with interactive charts
Next Quiz Predictions: AI predicts expected performance on upcoming quizzes
Personalized Study Tips: Custom recommendations for optimal study times and improvement areas

📊 Advanced Analytics & Reports ✅

Beautiful User Reports: Modern card layouts replacing clunky tables on mobile
Real-Time Performance Tracking: Live progress updates and achievements
Comprehensive Analytics: Category-wise performance breakdown
Visual Progress Indicators: Interactive charts for better understanding
Quiz History: Detailed performance reports with visual feedback
Score Analytics: Real-time feedback and comprehensive score tracking

🏆 Gamification

Achievements System ✅
- Earn badges like “Quiz Master,” “Speed Genius,” and “Perfect Score”
- View badges and stats in user profile
Leaderboards
- Weekly and monthly top scorers
- Promotes user engagement and competition

⚔️ Live Quiz Battles (Fully Implemented) ✅

Real-time multiplayer quiz competitions with Socket.IO
Live scoring with speed bonuses and instant feedback
Chat system for communication during battles
Room management with customizable settings

🎨 Next-Generation UI/UX ✅

Advanced Theme Selector with 15+ themes including Light/Dark/Material/Dracula/Nord modes
Mobile-First Design with responsive navigation bar for phones and tablets
Enhanced Dashboard with modern card-based layout and data visualization
Interactive Quiz Modal with progress tracking and mobile optimization
Gamification Hub with daily challenges and tournament management interface
PWA Installation Prompts with native app-like experience
Consistent Design System with polished animations and micro-interactions
Performance Optimized UI with 60fps animations and reduced computational overhead
Hardware Accelerated Transitions using CSS transforms and optimized backdrop-filters
Smooth Animation Framework with simplified framer-motion implementations for better performance

💳 Subscription Plans

Free Plan: Limited quizzes, core features, basic multiplayer access
Premium Plan: Unlimited access, AI Study Buddy, Intelligence Dashboard, advanced achievements, PWA features, and premium multiplayer battles

📚 Comprehensive Help System ✅

Interactive Help Guide: Step-by-step tutorials for every feature
User Type Explanations: Clear differences between Simple, Premium, and Admin users
Quiz Creation Tutorials: Complete guide for premium users
Troubleshooting Section: Solutions for common issues
Feature Walkthroughs: Detailed explanations of all platform capabilities
Mobile-Optimized Help: Responsive help system for all devices

🛡️ Admin Panel

A powerful admin dashboard providing full control of platform operations:

🔍 Monitor user activity and quiz submissions
🧩 Add/Edit/Delete quizzes and questions
👥 Manage users: roles, status, analytics
📈 Real-time insights and platform stats

🛠️ Tech Stack

Frontend: React, CSS, Vite, PWA Service Workers
Backend: Node.js, Express.js, MongoDB, Socket.IO
AI Integration: Google Gemini 2.5 Pro, Together AI
Real-Time: Socket.IO for multiplayer functionality
Authentication: JWT, Google OAuth
PWA: Service Worker, Web App Manifest, Push Notifications
Performance: Optimized CSS animations, hardware acceleration, reduced backdrop-filter usage
Animation Framework: Simplified framer-motion with performance-first approach
Caching Strategy: Intelligent service worker caching with network-first and cache-first strategies
Redis Caching: Production-ready Redis Cloud integration for session management and data caching
Logging System: Environment-aware logging with file storage (dev) and console output (production)
Deployment: Render with optimized caching strategies

🚀 NEW: Production-Ready Infrastructure

⚡ Redis Cloud Caching System

Session Management: Redis-based session storage for production scalability
Memory Store Fallback: Automatic fallback to MemoryStore in development
Production Optimization: No memory leaks, scales across multiple processes
Real-time Caching: Fast data retrieval and session persistence

📊 Smart Logging System

Environment Detection: Automatically switches between file and console logging
Development: Logs saved to logs/ folder + console output
Production: Console-only logging (Render dashboard integration)
Log Levels: info (dev) / warn (production) for optimal performance
Structured Logging: JSON format with timestamps and context

🧪 Enhanced Testing & Quality

Dynamic Category Detection: Real-time quiz categorization from database
Subject Performance Analytics: Dynamic chart generation with actual category names
Production Logging: Render-compatible logging without file system dependencies
Error Handling: Comprehensive error tracking and user-friendly messages

👤 Author

📩 For licensing or collaboration inquiries, feel free to reach out. ⚠️ Please do not remove credit in forks or copies. Attribution is required.

📦 Installation & Setup

🔗 Backend Setup

cd backend
npm install

Create a .env file in the backend folder with:

# Database
MONGO_URI=your_mongodb_uri

# Server Configuration
PORT=4000
NODE_ENV=development
LOG_LEVEL=info

# AI Services
TOGETHER_AI_API_KEY=your_ai_key
GEMINI_API_KEY=your_gemini_api_key

# Authentication
JWT_SECRET=your_jwt_secret
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_CALLBACK_URL=http://localhost:4000/api/users/google/callback
GOOGLE_SECRET=your_google_secret

# URLs
BACKEND_URL=http://localhost:4000
FRONTEND_URL=http://localhost:5173

# Redis Cloud (Production Caching)
REDIS_HOST=your_redis_host
REDIS_PORT=your_redis_port
REDIS_PASSWORD=your_redis_password
REDIS_DB=0
REDIS_SSL=true
REDIS_URL=redis://default:password@host:port

# Tidewatch dashboard (github.com/MaXiMo000/tidewatch), optional: set to serve aggregate
# health numbers (request rate, 5xx rate, p95 for the API, MongoDB, Redis and Gemini) at
# GET /tidewatch/metrics to whoever holds this token (Bearer). Unset = the route does not exist.
# TIDEWATCH_METRICS_TOKEN=

Start the backend server:

npm start

🚀 Production Deployment (Render)

For production deployment on Render, set these environment variables:

# Production Environment
NODE_ENV=production
LOG_LEVEL=warn
RENDER=true

# Your existing variables...
MONGO_URI=your_production_mongodb_uri
REDIS_URL=your_redis_cloud_url
JWT_SECRET=your_production_jwt_secret
# ... etc

Key Production Features:

✅ Redis Session Storage: No MemoryStore warnings
✅ Console Logging: Logs appear in Render dashboard
✅ Dynamic Categories: Real-time quiz categorization
✅ Optimized Performance: Production-ready caching and logging

💻 Frontend Setup

cd frontend
npm install

Create a .env file in the frontend folder with:

VITE_BACKEND_URL=https://your-backend-url.onrender.com
VITE_CONTACT_KEY=your_emailjs_key
VITE_CONTACT_SERVICE=your_emailjs_service
VITE_CONTACT_TEMPLATE=your_emailjs_template

For local testing:

VITE_BACKEND_URL=http://localhost:4000

Access env variables in React pages:

const BACKEND_URL = import.meta.env.VITE_BACKEND_URL;

Run the frontend dev server:

npm run dev

🗓️ Project Progress Timeline

Date	Commit Description
07-03-2025	Initial commit: basic project structure
08-03-2025	AI-based question generation added
09-03-2025	Improved UI and quiz-taking UX
10-03-2025	Auto duration/marks for AI questions, backend deployed
10-03-2025	Added written test with AI evaluation
10-03-2025	AuthWrapper + responsive layout
10-03-2025	Integrated JWT, enhanced frontend
23-07-2025	Advanced Theme Selector, Mobile Navbar, Test Page added
23-07-2025	Achievement System fully integrated
24-07-2025	Full UI consistency pass + New Dashboard design
25-07-2025	Intelligence Dashboard with AI insights added (Premium)
27-07-2025	Gamification Hub: Daily Challenges and Tournaments
27-07-2025	Enhanced Quiz Modal UI with mobile optimization
28-07-2025	AI Study Buddy: Google Gemini 2.5 Pro integration
28-07-2025	Real-Time Quiz Battles: Live multiplayer with Socket.IO
29-07-2025	Progressive Web App: PWA implementation with offline support
29-07-2025	Enhanced Features: Complete UI overhaul and feature integration
29-07-2025	Performance Optimization: Optimized animations for 60fps performance, reduced backdrop-filter usage, simplified framer-motion animations for smoother user experience
06-09-2025	Smart Quiz Experience: Intelligent fullscreen mode with auto-submit protection and performance optimization
06-09-2025	Advanced Analytics & Reports: Beautiful card layouts for mobile, real-time tracking, and comprehensive analytics
06-09-2025	World-Class UI/UX Overhaul: Glassmorphism design, smooth animations, and responsive mobile experience
06-09-2025	Comprehensive Help System: Interactive tutorials, user type explanations, and troubleshooting guides

✅ Completed Features

✅ Modern UI/UX Design with 15+ advanced themes
✅ AI-powered question generation with adaptive difficulty
✅ Google Gemini 2.5 Pro AI Study Buddy with personalized tutoring
✅ Real-Time Quiz Battles with live multiplayer functionality
✅ Progressive Web App (PWA) with offline support and push notifications
✅ JWT-based role management (User/Premium/Admin)
✅ Written tests with AI NLP evaluation
✅ Quiz result tracking and comprehensive reviews
✅ Achievement Badge System with 20+ unique badges 🏆
✅ Advanced Leaderboards (weekly/monthly/tournament-specific)
✅ Daily Challenges System with XP rewards
✅ Tournament System with competitive gameplay
✅ Free vs Premium user flow with feature differentiation
✅ Advanced Theme Selector with Material, Dracula, Nord themes 🌙
✅ Mobile-First Navigation with responsive design 📱
✅ Enhanced Dashboard & Test Pages with data visualization 🎯
✅ Intelligence Dashboard with AI-powered insights and predictions 🧠
✅ Gamification Hub with centralized gaming features 🏆
✅ Mobile-optimized Quiz Modal with progress tracking 📱
✅ Socket.IO Real-Time Communication for live features
✅ Service Worker Caching for offline functionality
✅ Push Notification System for user engagement
✅ Performance Optimized Animations with 60fps smooth transitions
✅ Hardware Accelerated UI using CSS transforms and optimized rendering
✅ Simplified Animation Framework with reduced computational overhead for better user experience
✅ Smart Quiz Experience with intelligent fullscreen mode and auto-submit protection 🎮
✅ Advanced Analytics & Reports with beautiful card layouts and real-time tracking 📊
✅ World-Class UI/UX Overhaul with glassmorphism design and smooth animations 🎨
✅ Comprehensive Help System with interactive tutorials and troubleshooting 📚
✅ Exceptional Features including auto-submit protection and cross-platform compatibility 🛡️

🔄 In Progress

⚔️ Live Quiz Battles
- Real-time 1v1 quiz mode
- View your opponent’s progress live

💬 Feedback & Contributions

Got feedback, ideas, or want to collaborate? Open an issue or a pull request — all contributions are welcome! 🙌

Name		Name	Last commit message	Last commit date
.github		.github
backend		backend
docs		docs
frontend		frontend
scripts		scripts
tests/unit		tests/unit
.gitignore		.gitignore
.hintrc		.hintrc
.node-version		.node-version
.pre-commit-config.yaml		.pre-commit-config.yaml
EMAILJS_SETUP.md		EMAILJS_SETUP.md
LICENSE		LICENSE
README.md		README.md
Read_Me.txt		Read_Me.txt
package.json		package.json
start.bat		start.bat
start.sh		start.sh

Latest commit

History

Folders and files

Repository files navigation