Skip to content

Latest commit

 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

🎯 SureScore — Confidence-Based Quiz Platform

MongoDB Express React Node.js JWT Vercel Render

An interactive MERN stack quiz platform designed for confidence-based learning, allowing teachers to manage quizzes and classrooms, and students to assess themselves intelligently.


🚀 Live Demo

🔗 Frontend: https://sure-score.vercel.app
🔗 Backend API: https://surescore.onrender.com


🧠 Overview

SureScore provides a smarter way to learn and test — by not only evaluating answers but also considering how confident the student was.
It’s designed to bring insightful analytics to both students and educators.


✨ Features

👩‍🏫 For Teachers

  • Create and manage classrooms
  • Create time-bound quizzes (MCQ & True/False)
  • View detailed performance analytics
  • Auto-submission when students leave tab or timer expires

🧑‍🎓 For Students

  • Join classrooms using unique codes
  • Attempt quizzes within the time limit
  • Mark confidence (1–5) for each answer
  • View detailed analysis & feedback reports

⚙️ System Features

  • JWT-based authentication
  • Confidence-based performance evaluation
  • Real-time score computation and storage
  • MongoDB database with optimized schema
  • Secure REST APIs using Express.js
  • Future ML model integration for adaptive analysis

🧩 Tech Stack

Layer Technology
Frontend React.js, TypeScript, Axios, TailwindCSS
Backend Node.js, Express.js
Database MongoDB (Mongoose ODM)
Authentication JWT (Access + Refresh Tokens)
Deployment Vercel (Frontend), Render (Backend)

🛠️ Installation & Setup

Prerequisites

  • Node.js ≥ 18
  • MongoDB Atlas / Local MongoDB

Steps

# 1. Clone the repository
git clone https://github.com/garvit65/SureScore.git
cd SureScore

# 2. Backend setup
cd backend
npm install
npm run dev  # or npm start

# 3. Frontend setup
cd ../frontend
npm install
npm run dev

Then open http://localhost:5173 to access the app.

📈 Future Enhancements

  • Machine Learning-based performance insights
  • Question tagging & difficulty prediction
  • Student growth trend visualization
  • Admin dashboard for institution-level analytics

🧑‍💻 Author

Garvit

🔗 Connect with me:
LinkedIn GitHub Gmail

⭐ Support

If you like this project, don’t forget to ⭐ star the repo and share feedback!

About

A quiz platform designed to facilitate interactive and confidence-based assessments for students and teachers.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages