🎓 Quizzer

A web-based quiz application built with Flask and Python to test knowledge with multiple-choice quizzes and email OTP authentication.

📌 Table of Contents

• Features
• Project Structure
• Quick Start
• Security Features
• Browser Compatibility
• Contributing
• License
• Support

✨ Features

• 🔒 Email OTP Verification: Secure login using one-time passwords sent via email
• 🎯 Multiple-Choice Quizzes: Test knowledge instantly
• 📊 Real-Time Scoring: Scores calculated as you finish each quiz
• 📋 User Registration & Login: Personalized experience
• 📱 Responsive Design: Works on desktop, tablet, and mobile

📂 Project Structure

quizzer/
│
├── app.py               # Main Flask app
├── templates/           # HTML templates
│   ├── index.html
│   ├── login.html
│   ├── register.html
│   └── quiz.html
├── static/              # CSS, JS, images
│   ├── style.css
│   └── script.js
├── requirements.txt     # Python dependencies
├── README.html          # Project README
└── .gitignore

🚀 Quick Start

1. 📥 Clone the repository:

   git clone https://github.com/yourusername/quizzer.git
   cd quizzer

2. 🌐 Set up virtual environment and install dependencies:

   python -m venv venv
   venv\Scripts\activate  # Windows
   source venv/bin/activate # macOS/Linux
   pip install -r requirements.txt

3. 🎯 Run the app:

   python app.py

   Open http://127.0.0.1:5000/ in your browser

🛡️ Security Features

• 🔐 OTP ensures secure login
• 💾 No user passwords stored in plaintext

🌐 Browser Compatibility

• ✅ Chrome 50+
• ✅ Firefox 45+
• ✅ Safari 10+
• ✅ Edge 13+

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

📄 License

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

📞 Support

• 🐛 Bug Reports: Open an issue
• 💡 Feature Requests: Start a discussion

---

⭐ Like this project? Give it a star! ⭐