Skip to content

Repository files navigation

🎓 ExamHub

A modern Computer-Based Testing (CBT) platform built with Flask and SQLite.

ExamHub allows students to securely log in, take timed examinations, navigate through questions, and receive instant results upon submission.


🚀 Features

  • 🔐 Secure Student Login
  • 📝 Computer-Based Examination
  • ⏱ Countdown Timer
  • ➡️ Next & Previous Question Navigation
  • 💾 Automatic Answer Saving
  • 🔄 Restore Previously Selected Answers
  • 📊 Automatic Scoring
  • 📋 Instant Result Page
  • 📱 Responsive Interface
  • 🗄 SQLite Database Backend

🖼 Screenshots

Screenshots will be added in future releases.


🛠 Tech Stack

  • Python 3
  • Flask
  • SQLite
  • HTML5
  • CSS3
  • Jinja2

📂 Project Structure

ExamHub/
│
├── app.py
├── database.py
├── students.db
├── templates/
├── static/
│   ├── css/
│   └── images/
├── README.md
└── requirements.txt

⚙ Installation

Clone the repository

git clone https://github.com/0xApana/ExamHub.git

Move into the project

cd ExamHub

Install dependencies

pip install -r requirements.txt

Run the application

python app.py

Open your browser

http://127.0.0.1:5000

🎯 Roadmap

✅ v0.1.0 (Current)

  • Authentication
  • CBT Engine
  • Navigation
  • Answer Tracking
  • Automatic Scoring
  • Countdown Timer

🚧 v0.2.0

  • Real Question Bank
  • Multiple Courses
  • Improved UI

🚀 v0.3.0

  • Administrator Dashboard
  • Student Registration
  • Question Management

⭐ v1.0.0

  • Production Ready Release
  • Advanced Analytics
  • Leaderboard
  • Export Results

🤝 Contributing

Contributions, suggestions and improvements are welcome.

Feel free to fork the project and submit a pull request.


📄 License

This project is licensed under the MIT License.


👨‍💻 Author

Ridwanullahi Apana > 0xApana

Computer Engineering Student

Federal University of Technology, Minna

GitHub: https://github.com/0xApana


⭐ If you found this project useful, consider giving it a star.

About

ExamHub is a CBT management system for creating and taking computer-based examinations.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages