Skip to content
/ Quiz-App Public
forked from MaXiMo000/Quiz-App

QuizNest is a full-stack, AI-powered quiz platform built with the MERN stack (MongoDB, Express.js, React.js, Node.js). It offers dynamic quiz generation, performance analytics, and gamified features to enhance user engagement.

quiz-app-cp2h.onrender.com/

License

MIT license
0 stars 3 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

codetoanbug/Quiz-App

BranchesTags
 
 

Repository files navigation

🧠 QuizNest – AI Quiz App

🌐 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
  • Deployment: Render with optimized caching strategies

👤 Author

Developed by MaXiMo000 All rights reserved © 2025

📩 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:

MONGO_URI=your_mongodb_uri
PORT=5000
TOGETHER_AI_API_KEY=your_ai_key
GEMINI_API_KEY=your_gemini_api_key
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/auth/google/callback
FRONTEND_URL=http://localhost:5173
GOOGLE_SECRET=your_google_secret

Start the backend server:

npm start

💻 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! 🙌

About

QuizNest is a full-stack, AI-powered quiz platform built with the MERN stack (MongoDB, Express.js, React.js, Node.js). It offers dynamic quiz generation, performance analytics, and gamified features to enhance user engagement.

quiz-app-cp2h.onrender.com/

Resources

Readme

License

MIT license
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 61.2%
  • CSS 35.5%
  • HTML 3.3%