Quiz App Documentation

Introduction

The Quiz App is an interactive platform designed to facilitate seamless quiz creation, management, and participation. Whether you're an educator, student, or just someone who enjoys quizzes, this app provides features for different user roles, making it easy to create, attempt, and evaluate quizzes.

How to Use the Quiz App

  • Home Page: Select options like Start Quiz, Create Quiz, or View Dashboard.
  • Start Quiz: Begin attempting available quizzes.
  • Create Quiz: Build quizzes manually or upload them using a CSV file.
  • Dashboard: Review quiz performance, statistics, and summaries.

Dashboard Overview

  • Total Questions: Number of questions in the quiz.
  • Attempted Questions: Number of questions you attempted.
  • Correct Answers: Number of questions answered correctly.
  • Incorrect Answers: Number of questions answered incorrectly.
  • Time Taken: Total time spent on the quiz.
  • Review Questions: Detailed view of each question, your answers, and the correct answers.

Exam Mode vs Practice Mode

Exam Mode:
  • Timer is enabled.
  • No hints or immediate feedback.
  • Cannot revisit previous questions.
Practice Mode:
  • Timer is optional.
  • Immediate feedback after selecting an answer.
  • Option to revisit previous questions.

How to Attempt a Quiz

  1. Select a quiz from the available list.
  2. Click on Start Quiz.
  3. Read each question carefully.
  4. Select an answer by clicking the desired option.
  5. Use the Next and Previous buttons to navigate.
  6. Submit the quiz after completing all questions.
  7. View your performance on the Dashboard.

How to Create Questions Manually

  • Navigate to the Create Quiz page.
  • Enter a Quiz Title.
  • Add a question in the Question Input Field.
  • Provide four answer options.
  • Select the correct answer.
  • Click Add Question.
  • Save the quiz once all questions are added.

Uploading Questions via CSV File

You can upload multiple quiz questions at once using a CSV (Comma-Separated Values) file. Follow the steps below to ensure a smooth upload:

📝 Step 1: Create a CSV File
  • Open a spreadsheet application like Microsoft Excel, Google Sheets, or any text editor (e.g., Notepad).
  • Create six columns in the following order:
    1. QuestionText - The text of the question.
    2. Option1 - First answer option.
    3. Option2 - Second answer option.
    4. Option3 - Third answer option.
    5. Option4 - Fourth answer option.
    6. CorrectAnswer - The correct answer (must match one of the options).
📊 Step 2: Format the Questions Properly

Ensure each row in the file represents a single question. Example: 

"QuestionText","Option1","Option2","Option3","Option4","CorrectAnswer"
"What is 2+2?","2","3","4","5","4"
"Capital of France?","Berlin","Madrid","Paris","Rome","Paris"
"Which planet is known as the Red Planet?","Earth","Mars","Jupiter","Saturn","Mars"
  • Each value is separated by a comma (,).
  • The correct answer must exactly match one of the provided options.
💾 Step 3: Save the File
  • If using Excel or Google Sheets, save the file as: quiz_questions.csv
  • Ensure the file type is selected as CSV (Comma delimited).
📤 Step 4: Upload the File
  • Navigate to the Create Quiz page.
  • Click on the Upload CSV File button.
  • Select your saved CSV file.
  • Click Submit and wait for the confirmation message.
✅ Step 5: Verify the Uploaded Questions
  • Ensure all questions are displayed correctly in the preview section.
  • Fix any errors in the CSV file and re-upload if needed.

Following these steps ensures your quiz questions are correctly uploaded and ready for use. Happy quizzing!