# ayush-mittal10/quizzly architecture

> Architecture diagram of the GitHub repository ayush-mittal10/quizzly, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ayush-mittal10/quizzly
- Repository: https://github.com/ayush-mittal10/quizzly

## Overview

Quizzly supports professor-managed quizzes and student quiz-taking, with integrity checks and live professor monitoring. The main flow routes users through authentication, quiz setup or joining, the timed attempt, submission, and results; monitoring adds event tracking and WebRTC video. Edges cite the route wiring, observed calls, or documented capabilities. Some page and helper implementations were not excerpted, so uncertain internal links are omitted.

Main entry points: [`src/App.tsx`](https://github.com/ayush-mittal10/quizzly/blob/main/src/App.tsx) (App routes), [`src/pages/TakeQuiz.tsx`](https://github.com/ayush-mittal10/quizzly/blob/main/src/pages/TakeQuiz.tsx) (Take quiz), [`src/integrations/supabase/client.ts`](https://github.com/ayush-mittal10/quizzly/blob/main/src/integrations/supabase/client.ts) (Supabase client), [`src/pages/MonitorQuiz.tsx`](https://github.com/ayush-mittal10/quizzly/blob/main/src/pages/MonitorQuiz.tsx) (Professor monitor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access &amp; routing"]
  node_app["App routes<br/>[App.tsx]"]
  node_auth["Auth context<br/>[AuthContext.tsx]"]
  node_protected["Role guard<br/>[ProtectedRoute.tsx]"]
  node_login["Login &amp; registration"]
end

subgraph group_quiz["Quiz lifecycle"]
  node_dashboard["Role dashboards"]
  node_create["Quiz authoring<br/>[CreateQuiz.tsx]"]
  node_ai["AI question generation"]
  node_quizutils["Quiz operations<br/>[quizUtils.ts]"]
  node_join["Join quiz<br/>[JoinQuiz.tsx]"]
  node_lookup["Quiz lookup<br/>[useQuizByTestId.ts]"]
  node_take["Take quiz<br/>[TakeQuiz.tsx]"]
  node_attempts["Attempt tracking"]
  node_results["Results analysis<br/>[useQuizResults.ts]"]
end

subgraph group_integrity["Integrity monitoring"]
  node_monitorpage["Professor monitor<br/>[MonitorQuiz.tsx]"]
  node_monitorhook["Live attempt monitor"]
  node_video["Student video view"]
  node_faces["Face detection"]
  node_rtc["WebRTC signaling<br/>[webRTCUtils.ts]"]
end

subgraph group_platform["Supabase platform"]
  node_supabase["Supabase client<br/>[client.ts]"]
  node_database[("Supabase services")]
  node_types["Attempt data types<br/>[database.ts]"]
end

node_professor(("Professor"))
node_student(("Student"))

node_student -->|"opens"| node_app
node_professor -->|"opens"| node_app
node_app -->|"provides auth"| node_auth
node_app -->|"guards routes"| node_protected
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_create
node_app -->|"routes to"| node_join
node_app -->|"routes to"| node_take
node_app -->|"routes to"| node_monitorpage
node_auth -->|"auth &amp; profile calls"| node_supabase
node_create -->|"uses"| node_quizutils
node_create -->|"renders"| node_ai
node_join -->|"loads quiz"| node_lookup
node_join -->|"checks attempts"| node_attempts
node_take -->|"loads quiz"| node_lookup
node_take -->|"uses"| node_quizutils
node_take -->|"runs checks"| node_faces
node_take -->|"starts video"| node_rtc
node_take -->|"persists attempt"| node_supabase
node_professor -->|"monitors"| node_monitorpage
node_monitorpage -->|"loads live status"| node_monitorhook
node_monitorpage -->|"renders student feeds"| node_video
node_monitorhook -->|"queries &amp; subscribes"| node_supabase
node_video -->|"connects to student"| node_rtc
node_video -->|"detects faces"| node_faces
node_rtc -->|"reads signaling data"| node_supabase
node_supabase -->|"accesses"| node_database
node_attempts -->|"queries"| node_supabase
node_results -->|"queries"| node_supabase
node_rtc -->|"uses attempt types"| node_types
node_take -->|"uses attempt types"| node_types

click node_app "https://github.com/ayush-mittal10/quizzly/blob/main/src/App.tsx"
click node_auth "https://github.com/ayush-mittal10/quizzly/blob/main/src/contexts/AuthContext.tsx"
click node_protected "https://github.com/ayush-mittal10/quizzly/blob/main/src/components/ProtectedRoute.tsx"
click node_login "https://github.com/ayush-mittal10/quizzly/tree/main/src/components/auth"
click node_dashboard "https://github.com/ayush-mittal10/quizzly/tree/main/src/components/dashboard"
click node_create "https://github.com/ayush-mittal10/quizzly/blob/main/src/pages/CreateQuiz.tsx"
click node_ai "https://github.com/ayush-mittal10/quizzly/blob/main/src/components/quiz/AiQuestionGenerator.tsx"
click node_quizutils "https://github.com/ayush-mittal10/quizzly/blob/main/src/utils/quizUtils.ts"
click node_join "https://github.com/ayush-mittal10/quizzly/blob/main/src/pages/JoinQuiz.tsx"
click node_lookup "https://github.com/ayush-mittal10/quizzly/blob/main/src/hooks/useQuizByTestId.ts"
click node_take "https://github.com/ayush-mittal10/quizzly/blob/main/src/pages/TakeQuiz.tsx"
click node_attempts "https://github.com/ayush-mittal10/quizzly/blob/main/src/hooks/useStudentAttempts.ts"
click node_results "https://github.com/ayush-mittal10/quizzly/blob/main/src/hooks/useQuizResults.ts"
click node_monitorpage "https://github.com/ayush-mittal10/quizzly/blob/main/src/pages/MonitorQuiz.tsx"
click node_monitorhook "https://github.com/ayush-mittal10/quizzly/blob/main/src/hooks/useQuizMonitoring.ts"
click node_video "https://github.com/ayush-mittal10/quizzly/blob/main/src/components/quiz/StudentVideoMonitor.tsx"
click node_faces "https://github.com/ayush-mittal10/quizzly/blob/main/src/utils/faceDetectionUtils.ts"
click node_rtc "https://github.com/ayush-mittal10/quizzly/blob/main/src/utils/webRTCUtils.ts"
click node_supabase "https://github.com/ayush-mittal10/quizzly/blob/main/src/integrations/supabase/client.ts"
click node_types "https://github.com/ayush-mittal10/quizzly/blob/main/src/types/database.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_auth,node_protected,node_login toneBlue
class node_dashboard,node_create,node_ai,node_quizutils,node_join,node_lookup,node_take,node_attempts,node_results toneAmber
class node_monitorpage,node_monitorhook,node_video,node_faces,node_rtc toneMint
class node_supabase,node_database,node_types toneRose
class node_professor,node_student toneIndigo
```

## Components

### Access & routing

- [App routes](https://github.com/ayush-mittal10/quizzly/blob/main/src/App.tsx): `src/App.tsx`
- [Auth context](https://github.com/ayush-mittal10/quizzly/blob/main/src/contexts/AuthContext.tsx): `src/contexts/AuthContext.tsx`
- [Role guard](https://github.com/ayush-mittal10/quizzly/blob/main/src/components/ProtectedRoute.tsx): `src/components/ProtectedRoute.tsx`
- [Login & registration](https://github.com/ayush-mittal10/quizzly/tree/main/src/components/auth): `src/components/auth`

### Quiz lifecycle

- [Role dashboards](https://github.com/ayush-mittal10/quizzly/tree/main/src/components/dashboard): `src/components/dashboard`
- [Quiz authoring](https://github.com/ayush-mittal10/quizzly/blob/main/src/pages/CreateQuiz.tsx): `src/pages/CreateQuiz.tsx`
- [AI question generation](https://github.com/ayush-mittal10/quizzly/blob/main/src/components/quiz/AiQuestionGenerator.tsx): `src/components/quiz/AiQuestionGenerator.tsx`
- [Quiz operations](https://github.com/ayush-mittal10/quizzly/blob/main/src/utils/quizUtils.ts): `src/utils/quizUtils.ts`
- [Join quiz](https://github.com/ayush-mittal10/quizzly/blob/main/src/pages/JoinQuiz.tsx): `src/pages/JoinQuiz.tsx`
- [Quiz lookup](https://github.com/ayush-mittal10/quizzly/blob/main/src/hooks/useQuizByTestId.ts): `src/hooks/useQuizByTestId.ts`
- [Take quiz](https://github.com/ayush-mittal10/quizzly/blob/main/src/pages/TakeQuiz.tsx): `src/pages/TakeQuiz.tsx`
- [Attempt tracking](https://github.com/ayush-mittal10/quizzly/blob/main/src/hooks/useStudentAttempts.ts): `src/hooks/useStudentAttempts.ts`
- [Results analysis](https://github.com/ayush-mittal10/quizzly/blob/main/src/hooks/useQuizResults.ts): `src/hooks/useQuizResults.ts`

### Integrity monitoring

- [Professor monitor](https://github.com/ayush-mittal10/quizzly/blob/main/src/pages/MonitorQuiz.tsx): `src/pages/MonitorQuiz.tsx`
- [Live attempt monitor](https://github.com/ayush-mittal10/quizzly/blob/main/src/hooks/useQuizMonitoring.ts): `src/hooks/useQuizMonitoring.ts`
- [Student video view](https://github.com/ayush-mittal10/quizzly/blob/main/src/components/quiz/StudentVideoMonitor.tsx): `src/components/quiz/StudentVideoMonitor.tsx`
- [Face detection](https://github.com/ayush-mittal10/quizzly/blob/main/src/utils/faceDetectionUtils.ts): `src/utils/faceDetectionUtils.ts`
- [WebRTC signaling](https://github.com/ayush-mittal10/quizzly/blob/main/src/utils/webRTCUtils.ts): `src/utils/webRTCUtils.ts`

### Supabase platform

- [Supabase client](https://github.com/ayush-mittal10/quizzly/blob/main/src/integrations/supabase/client.ts): `src/integrations/supabase/client.ts`
- **Supabase services**
- [Attempt data types](https://github.com/ayush-mittal10/quizzly/blob/main/src/types/database.ts): `src/types/database.ts`

### Other components

- **Professor**
- **Student**

## Connections

- Student → App routes: opens (evidence: `src/App.tsx`)
- Professor → App routes: opens (evidence: `src/App.tsx`)
- App routes → Auth context: provides auth (evidence: `src/App.tsx`)
- App routes → Role guard: guards routes (evidence: `src/App.tsx`)
- App routes → Login & registration: routes to (evidence: `src/App.tsx`)
- App routes → Role dashboards: routes to (evidence: `src/App.tsx`)
- App routes → Quiz authoring: routes to (evidence: `src/App.tsx`)
- App routes → Join quiz: routes to (evidence: `src/App.tsx`)
- App routes → Take quiz: routes to (evidence: `src/App.tsx`)
- App routes → Professor monitor: routes to (evidence: `src/App.tsx`)
- Auth context → Supabase client: auth & profile calls (evidence: `src/contexts/AuthContext.tsx`)
- Quiz authoring → Quiz operations: uses (evidence: `src/pages/CreateQuiz.tsx`)
- Quiz authoring → AI question generation: renders (evidence: `src/pages/CreateQuiz.tsx`)
- Join quiz → Quiz lookup: loads quiz (evidence: `src/pages/JoinQuiz.tsx`)
- Join quiz → Attempt tracking: checks attempts (evidence: `src/pages/JoinQuiz.tsx`)
- Take quiz → Quiz lookup: loads quiz (evidence: `src/pages/TakeQuiz.tsx`)
- Take quiz → Quiz operations: uses (evidence: `src/pages/TakeQuiz.tsx`)
- Take quiz → Face detection: runs checks (evidence: `src/pages/TakeQuiz.tsx`)
- Take quiz → WebRTC signaling: starts video (evidence: `src/pages/TakeQuiz.tsx`)
- Take quiz → Supabase client: persists attempt (evidence: `src/pages/TakeQuiz.tsx`)
- Professor → Professor monitor: monitors (evidence: `README.md`)
- Professor monitor → Live attempt monitor: loads live status (evidence: `src/pages/MonitorQuiz.tsx`)
- Professor monitor → Student video view: renders student feeds (evidence: `src/pages/MonitorQuiz.tsx`)
- Live attempt monitor → Supabase client: queries & subscribes (evidence: `src/hooks/useQuizMonitoring.ts`)
- Student video view → WebRTC signaling: connects to student (evidence: `src/components/quiz/StudentVideoMonitor.tsx`)
- Student video view → Face detection: detects faces (evidence: `src/components/quiz/StudentVideoMonitor.tsx`)
- WebRTC signaling → Supabase client: reads signaling data (evidence: `src/utils/webRTCUtils.ts`)
- Supabase client → Supabase services: accesses (evidence: `src/integrations/supabase/client.ts`)
- Attempt tracking → Supabase client: queries (evidence: `src/hooks/useStudentAttempts.ts`)
- Results analysis → Supabase client: queries (evidence: `src/hooks/useQuizResults.ts`)
- WebRTC signaling → Attempt data types: uses attempt types (evidence: `src/utils/webRTCUtils.ts`)
- Take quiz → Attempt data types: uses attempt types (evidence: `src/pages/TakeQuiz.tsx`)
