Skip to content

HeatBlastee/Quizme

Repository files navigation

🎯 QuizMe

QuizMe is a modern quiz web application designed to make learning interactive and engaging. Users can take quizzes, get instant results, and improve their knowledge across various topics. Ideal for students, educators, and knowledge enthusiasts!


🚀 Features

  • 📝 Create and manage quizzes
  • 🧠 Attempt quizzes and get instant feedback
  • 📊 See performance analytics
  • 👨‍🏫 Role-based access (Admin/User)
  • 🌐 Responsive UI for all devices
  • 🔐 Authentication & Authorization
  • 💾 Persistent storage of quiz data and scores

🛠️ Tech Stack

Frontend:

  • React.js
  • Tailwind CSS
  • Axios

Backend:

  • Node.js
  • Express.js
  • MongoDB (Mongoose)

Authentication:

  • JWT-based authentication
  • bcrypt password hashing

📦 Installation

# Clone the repo
git clone https://github.com/HeatBlastee/QuizMe.git
cd QuizMe

# Install frontend & backend dependencies
cd client
npm install
cd ../server
npm install

▶️ Usage

  1. Start Backend Server

    cd server
    npm start
  2. Start Frontend

    cd client
    npm run dev
  3. Open your browser and visit:
    http://localhost:5173 (or the appropriate port)


🧪 Sample Credentials

(Optional - for testing/demo purposes)

Admin
Email: admin@quizme.com
Password: admin123

User
Email: user@quizme.com
Password: user123


📂 Folder Structure

QuizMe/
├── client/         # Frontend (React)
├── server/         # Backend (Node/Express)
└── README.md

🛡️ Security

  • Passwords hashed with bcrypt
  • JWT for token-based authentication
  • Input validation on both frontend and backend

📈 Future Enhancements

  • Timer-based quizzes ⏱️
  • Leaderboards 🏆
  • Quiz sharing via public links 🔗
  • Mobile application version 📱

🤝 Contributing

Contributions are welcome! Feel free to open issues, submit pull requests, or suggest new features.


📬 Contact

Mann Patel
📧 mann110406@gmail.com
🔗 GitHub
🔗 LinkedIn


⭐️ Show Your Support

If you like the project, consider starring ⭐ the repository or sharing it with your network!

About

A Personalized Ai-Quiz-generator

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors