Quiz Management System

Quiz Management System is a simple yet fully functional quiz web application developed using the MERN stack. It includes secure user authentication with JWT, full CRUD operations for quizzes and questions, score tracking, and dashboards for both admin and users. This project is ideal for students who want to understand how real quiz platforms work internally and how authentication, backend APIs, and frontend interfaces come together in a complete web application.

Quizzy has two major roles: Admin and User. The admin manages quizzes, questions, and user attempts, while users attempt quizzes and view their results. The codebase you provided contains clear separation between client and server folders, secure middleware, API routing, and reusable React components, making it a highly educational real-world project.

Best Final Year Project For Data Science :–Click Here

Overview

Available Features

Below features are taken directly from the project files you uploaded. No extra or missing features are added.

Admin Features

• Admin Login Authentication
  Admin can log in securely. Invalid credentials show an error message, and successful login redirects to the admin dashboard.
• Quiz Management
  Admin can add, edit, and delete quizzes. Each quiz has a title, description, and timer.
• Question Management
  Admin can add, edit, and delete multiple-choice questions for each quiz.
• View Quizzes
  All created quizzes are listed with management options.
• View Scores
  Admin can view scores of all users or scores from a specific quiz.
• Dashboard
  Displays essential data such as total quizzes, total questions, and user attempts.

User Features

• View Quizzes
  Users can see all available quizzes created by the admin.
• Attempt Quizzes
  Users can attempt quizzes they have not attempted before. If already attempted, an appropriate message is displayed.
• View Scores
  After completing any quiz, score details are shown.
• View Attempts
  Users can view all previously attempted quizzes along with scores.
• Dashboard
  Shows user-related statistics such as attempts and performance summary.

Best Advanced Python Projects:-Click Here

Technologies Used

• Frontend: React.js (Vite-based setup)
• Backend: Node.js, Express.js
• Database: MongoDB
• Authentication: JSON Web Token (JWT)

Installation Guide (VS Code)

Below is the complete and correct installation guide based on the project structure you uploaded.

Step 1: Install Required Software

• Install Node.js
• Install MongoDB
• Install VS Code

Step 2: Extract the Project

Extract the Quiz Management System file.

Your folder structure should look like:

Quiz Management System /
  client/
  server/

Step 3: Open in VS Code

Download New Real Time Projects :–Click here

Open the extracted folder in VS Code:

File → Open Folder → Quiz Management System

Step 4: Install Dependencies

For Client

Open a terminal and run:

cd client
npm install

For Server

Open another terminal:

cd server
npm install

Step 5: Create Environment Files

Client .env

Located in client/.env
(Your project already contains one; verify the URL.)

Example:

VITE_BASE_URL=http://localhost:5000

Server .env

Create the file manually inside the server folder:

cd server
touch .env

Add:

MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_secret_key
PORT=5000

Step 6: Start MongoDB

Best Final Year Project For JAVA :- Click Here

If running locally:

mongod

Step 7: Start Backend

cd server
npm start

If nodemon is installed:

nodemon index.js

Step 8: Start Frontend

cd client
npm run dev

You will see a local development URL such as:

http://localhost:5173/

Open it in your browser.

Usage

This section explains how Admin and User roles use the system based on real functionalities in your uploaded project.

Admin Usage

As a student exploring the backend of full-stack systems, the admin role teaches you how CRUD operations and authentication work.

Best Final Year Project For SPRINGBOOT:–Click Here

1. Login

Admin logs in using predefined credentials. The server validates the credentials and generates a JWT token, demonstrating modern authentication flows.

2. Dashboard Access

The admin dashboard displays:

• Number of quizzes
• Number of questions
• User attempt statistics

This teaches how to aggregate database data and display meaningful analytics.

3. Create Quizzes

Admin adds:

• Title
• Description (optional)
• Timer duration

This helps students understand how forms, schema validation, and API endpoints interact.

Best Final Year Project For JSP :- Click Here

4. Add Questions

Admin selects a quiz and adds multiple-choice questions.

Each question contains:

• Question text
• Options
• Correct answer

The code clearly shows how nested data relationships are handled in MongoDB.

5. Manage Quizzes and Questions

Admin can:

• Edit quiz title or timer
• Modify questions
• Delete quizzes or questions

This teaches real-life use of PUT and DELETE API methods.

6. View User Scores

Admin can check:

• Who attempted which quiz
• Scores achieved
• Attempt timestamps

This is very helpful for understanding backend logics like filtering and relational queries.

User Usage

The user module demonstrates how real test-taking systems work.

1. User Dashboard

Once logged in, the user dashboard shows:

• Number of quizzes attempted
• Summaries of performance

This section helps students understand how to fetch and display personalized data.

2. View Quizzes

Users can browse all quizzes created by the admin. Each quiz card displays:

• Title
• Description
• Timer

This teaches frontend students how to render dynamic content from APIs.

3. Attempt a Quiz

Questions appear one by one (or in a list depending on UI). After answering all questions:

• The server calculates score
• Score is stored in the Attempt model

This helps students understand:

• State management
• Form handling
• API communication

4. View Attempt History

Users can review past quiz attempts anytime.
This shows how to fetch authenticated user-specific data securely.

Why This Project Is Useful for Students

From a student’s perspective, Quizzy is an excellent learning project because it covers real-world fundamentals:

Full MERN Stack Understanding

You get hands-on experience with frontend, backend, database, and authentication.

Practical CRUD Operations

Managing quizzes and questions shows exactly how modern applications handle data.

Secure Authentication

JWT implementation teaches:

• Token generation
• Token storage
• Protected routes

which are critical for all serious applications.

Real-Life Application

This type of quiz system is commonly used in:

• Schools and colleges
• Online training platforms
• Skill-testing websites
• Certification platforms

Because it is a real working model (not theoretical), students understand how such systems behave in real professional environments.

We have Best projects Available in all languages:–Click Here

Clean File Structure

Your uploaded project contains:

• Reusable React components
• API route separation
• Controllers and models
• Middleware for authentication

This mirrors industry-standard practices.

API Integration Skills

Students learn:

• How to call backend APIs
• How to manage responses
• How to handle error messages

This builds confidence for bigger projects.