Quizzz

An interactive quiz platform that turns lecture content and documents into playable quizzes, with AI-assisted editing for better question quality and variety.

View CodeLive Demo

Overview

Quizzz is a full-stack quiz creation and play platform built for fast revision workflows. Users can import quizzes from DOCX/PDF or generate new quizzes from lecture content, then immediately play them in an interactive format. An AI assistant helps clean up inputs, fill missing answers, rephrase questions, and vary numeric values to improve quiz quality and replayability.

Key Features

  • •Interactive quiz player with instant feedback and session flow (playable quiz experience)
  • •Document import (DOCX/PDF) to auto-extract questions, choices, and answers
  • •AI-assisted editing: fill missing answers, rephrase questions, vary numbers, improve consistency
  • •Lecture-to-quiz generation for quick practice sets
  • •Validation and error handling for messy real-world instructor formatting
  • •Export options for platform-ready quiz formats (if you support this)

Tech Stack

Frontend

React, TypeScript, CSS

Backend

Python, FastAPI, Pydantic, SQLAlchemy

Database

PostgreSQL

DevOps

Docker, Vercel

AI & APIs

RestAPI

Challenges & Solutions

Challenge:

Handling inconsistent DOCX/PDF formatting (mixed bullets, numbering styles, missing labels, uneven spacing)

Solution:

Built a parsing + validation pipeline with format-tolerant extraction rules and clear error reporting to keep imports reliable.

Challenge:

Keeping quizzes playable even when source content is incomplete (missing answers, unclear phrasing)

Solution:

Added AI-assisted workflows to complete missing fields and rewrite questions while enforcing formatting and validation constraints.

Challenge:

Maintaining consistent user experience from “import/generate” to “play”

Solution:

Designed a structured quiz data model and unified transformation steps so imported, AI-edited, and generated quizzes all play the same way.

Learning Outcomes

  • ✓Developed experience designing a playable, user-focused quiz platform, balancing content generation, validation, and interactive quiz flow.
  • ✓Learned how to process unstructured real-world documents (DOCX/PDF) and reliably transform them into structured, reusable quiz data.
  • ✓Gained hands-on experience integrating AI-assisted workflows to enhance content quality, including completing missing answers, rephrasing questions, and generating quizzes from lecture material.
  • ✓Strengthened full-stack development skills by connecting frontend interactions with backend processing through RESTful APIs.
  • ✓Improved system design skills by enforcing consistent data models and validation rules across imported, AI-generated, and user-edited quizzes.