Skip to content

This website offers a React JS quiz where users can answer multiple-choice questions. The questions increase or decrease in difficulty based on the user's answers. The website also features graphs, a hall of fame, login/registration, and user stats to track their progress

Notifications You must be signed in to change notification settings

VishnuPScodes/quizApp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

90 Commits
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽฏ Adaptive Quiz App

An interactive quiz application that adapts question difficulty based on user performance. Features a dynamic scoring system, user authentication, and an admin panel for question management.

โœจ Features

  • Adaptive Difficulty: Questions adjust based on user performance
  • Real-time Scoring: Dynamic score tracking during quiz sessions
  • User Authentication: Secure login/registration system with password reset
  • Hall of Fame: Leaderboard showcasing top performers
  • Personal Stats: Track your performance metrics
  • Admin Panel: Manage quiz questions and difficulty levels
  • Interactive UI: Beautiful particle effects and smooth transitions

๐Ÿš€ Tech Stack

Frontend

  • React.js with Vite
  • Redux for state management
  • Chakra UI & Material UI
  • Particle effects for enhanced visuals
  • D3.js for data visualization

Backend

  • Node.js & Express
  • MongoDB with Mongoose
  • JWT Authentication
  • Nodemailer for email notifications

๐Ÿ› ๏ธ Installation

  1. Clone the repository:
git clone https://github.com/VishnuPScodes/quizApp
  1. Install dependencies for both frontend and backend:
# Frontend
cd front-end
npm install

# Backend
cd ../Back-end
npm install
  1. Set up environment variables:
# Frontend (.env)
VITE_BASE_URL=http://localhost:4001

# Backend (.env)
PORT=4001
MONGODB_URI=your_mongodb_uri
JWT_SECRET=your_jwt_secret
  1. Start the development servers:
# Backend
cd Back-end
npm run dev

# Frontend
cd front-end
npm run dev

๐ŸŽฎ How to Play

  1. Register/Login to your account
  2. Start a new quiz session
  3. Answer questions within the time limit
  4. Watch your score adapt based on performance
  5. Save your score to the Hall of Fame
  6. Track your progress in My Stats

๐Ÿ‘จโ€๐Ÿ’ผ Admin Features

  • Add new questions to the question bank
  • Set difficulty levels for questions
  • Monitor user performance
  • Manage question pool

๐ŸŒ Live Demo

Check out the live application: Quiz App Demo

๐Ÿ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.


Made with โค๏ธ by Vishnu PS

About

This website offers a React JS quiz where users can answer multiple-choice questions. The questions increase or decrease in difficulty based on the user's answers. The website also features graphs, a hall of fame, login/registration, and user stats to track their progress

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •