# guru071/friend_quiz architecture

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

- Interactive diagram: https://gitdiagram.com/guru071/friend_quiz
- Repository: https://github.com/guru071/friend_quiz

## Overview

Sofiya is a social quiz-making and quiz-playing app: users create and publish quizzes, others join by code, play, and see results and leaderboard standings. The app also supports profiles, badges, reactions, sharing, and AI-assisted text correction. The graph emphasizes the documented app orchestration and the calls visible in excerpts; several substantial screens are represented, but their internal data flows are omitted where source was not sampled.

Main entry points: [`src/App.tsx`](https://github.com/guru071/friend_quiz/blob/main/src/App.tsx) (App coordinator), [`src/components/QuizPlayer.tsx`](https://github.com/guru071/friend_quiz/blob/main/src/components/QuizPlayer.tsx) (Quiz player), [`src/services/firestoreService.ts`](https://github.com/guru071/friend_quiz/blob/main/src/services/firestoreService.ts) (Quiz data access), [`src/services/badgeService.ts`](https://github.com/guru071/friend_quiz/blob/main/src/services/badgeService.ts) (Badge awards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Quiz experience"]
  node_app["App coordinator<br/>[App.tsx]"]
  node_nav["Navigation<br/>[Navbar.tsx]"]
  node_home["Quiz discovery<br/>[HomeSection.tsx]"]
  node_creator["Quiz creator<br/>[QuizCreator.tsx]"]
  node_join["Join quiz<br/>[JoinQuizModal.tsx]"]
  node_lobby["Quiz lobby<br/>[QuizLobby.tsx]"]
  node_player["Quiz player<br/>[QuizPlayer.tsx]"]
  node_results["Quiz results<br/>[QuizResult.tsx]"]
end

subgraph group_social["Community and profiles"]
  node_leaderboard["Leaderboard"]
  node_sharing["Quiz sharing<br/>[ShareQuizModal.tsx]"]
  node_profile["User profile"]
end

subgraph group_services["Application services"]
  node_badges["Badge awards<br/>[badgeService.ts]"]
  node_quizdata["Quiz data access"]
  node_scoring["Quiz scoring<br/>[scoring.ts]"]
  node_spellcheck["AI spell correction<br/>[aiSpellCheck.ts]"]
  node_sound["Sound effects<br/>[audio.ts]"]
  node_models["Quiz domain models<br/>[quiz.ts]"]
end

subgraph group_platform["Firebase platform"]
  node_firebase["Firebase setup<br/>[firebase.ts]"]
  node_firestore[("Firestore")]
end

node_user(("Quiz user"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_nav
node_app -->|"renders"| node_home
node_app -->|"renders"| node_creator
node_app -->|"renders"| node_join
node_app -->|"renders"| node_lobby
node_app -->|"renders"| node_player
node_app -->|"renders"| node_results
node_app -->|"renders"| node_leaderboard
node_app -->|"renders"| node_sharing
node_app -->|"renders"| node_profile
node_app -->|"loads quiz"| node_quizdata
node_app -->|"records awards"| node_badges
node_creator -->|"saves quiz"| node_quizdata
node_player -->|"saves results"| node_quizdata
node_player -->|"uses scoring"| node_scoring
node_player -->|"requests correction"| node_spellcheck
node_player -->|"plays effects"| node_sound
node_quizdata -->|"uses setup"| node_firebase
node_firebase -->|"connects"| node_firestore
node_badges -->|"reads and writes"| node_firestore
node_badges -->|"uses types"| node_models
node_quizdata -->|"uses types"| node_models

click node_app "https://github.com/guru071/friend_quiz/blob/main/src/App.tsx"
click node_nav "https://github.com/guru071/friend_quiz/blob/main/src/components/Navbar.tsx"
click node_home "https://github.com/guru071/friend_quiz/blob/main/src/components/HomeSection.tsx"
click node_creator "https://github.com/guru071/friend_quiz/blob/main/src/components/QuizCreator.tsx"
click node_join "https://github.com/guru071/friend_quiz/blob/main/src/components/JoinQuizModal.tsx"
click node_lobby "https://github.com/guru071/friend_quiz/blob/main/src/components/QuizLobby.tsx"
click node_player "https://github.com/guru071/friend_quiz/blob/main/src/components/QuizPlayer.tsx"
click node_results "https://github.com/guru071/friend_quiz/blob/main/src/components/QuizResult.tsx"
click node_leaderboard "https://github.com/guru071/friend_quiz/blob/main/src/components/LeaderboardView.tsx"
click node_sharing "https://github.com/guru071/friend_quiz/blob/main/src/components/ShareQuizModal.tsx"
click node_profile "https://github.com/guru071/friend_quiz/blob/main/src/components/UserProfileModal.tsx"
click node_badges "https://github.com/guru071/friend_quiz/blob/main/src/services/badgeService.ts"
click node_quizdata "https://github.com/guru071/friend_quiz/blob/main/src/services/firestoreService.ts"
click node_scoring "https://github.com/guru071/friend_quiz/blob/main/src/services/scoring.ts"
click node_spellcheck "https://github.com/guru071/friend_quiz/blob/main/src/services/aiSpellCheck.ts"
click node_sound "https://github.com/guru071/friend_quiz/blob/main/src/services/audio.ts"
click node_models "https://github.com/guru071/friend_quiz/blob/main/src/types/quiz.ts"
click node_firebase "https://github.com/guru071/friend_quiz/blob/main/src/services/firebase.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_nav,node_home,node_creator,node_join,node_lobby,node_player,node_results,node_user toneBlue
class node_leaderboard,node_sharing,node_profile toneAmber
class node_badges,node_quizdata,node_scoring,node_spellcheck,node_sound,node_models toneMint
class node_firebase,node_firestore toneRose
```

## Components

### Quiz experience

- [App coordinator](https://github.com/guru071/friend_quiz/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation](https://github.com/guru071/friend_quiz/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Quiz discovery](https://github.com/guru071/friend_quiz/blob/main/src/components/HomeSection.tsx): `src/components/HomeSection.tsx`
- [Quiz creator](https://github.com/guru071/friend_quiz/blob/main/src/components/QuizCreator.tsx): `src/components/QuizCreator.tsx`
- [Join quiz](https://github.com/guru071/friend_quiz/blob/main/src/components/JoinQuizModal.tsx): `src/components/JoinQuizModal.tsx`
- [Quiz lobby](https://github.com/guru071/friend_quiz/blob/main/src/components/QuizLobby.tsx): `src/components/QuizLobby.tsx`
- [Quiz player](https://github.com/guru071/friend_quiz/blob/main/src/components/QuizPlayer.tsx): `src/components/QuizPlayer.tsx`
- [Quiz results](https://github.com/guru071/friend_quiz/blob/main/src/components/QuizResult.tsx): `src/components/QuizResult.tsx`

### Community and profiles

- [Leaderboard](https://github.com/guru071/friend_quiz/blob/main/src/components/LeaderboardView.tsx): `src/components/LeaderboardView.tsx`
- [Quiz sharing](https://github.com/guru071/friend_quiz/blob/main/src/components/ShareQuizModal.tsx): `src/components/ShareQuizModal.tsx`
- [User profile](https://github.com/guru071/friend_quiz/blob/main/src/components/UserProfileModal.tsx): `src/components/UserProfileModal.tsx`

### Application services

- [Badge awards](https://github.com/guru071/friend_quiz/blob/main/src/services/badgeService.ts): `src/services/badgeService.ts`
- [Quiz data access](https://github.com/guru071/friend_quiz/blob/main/src/services/firestoreService.ts): `src/services/firestoreService.ts`
- [Quiz scoring](https://github.com/guru071/friend_quiz/blob/main/src/services/scoring.ts): `src/services/scoring.ts`
- [AI spell correction](https://github.com/guru071/friend_quiz/blob/main/src/services/aiSpellCheck.ts): `src/services/aiSpellCheck.ts`
- [Sound effects](https://github.com/guru071/friend_quiz/blob/main/src/services/audio.ts): `src/services/audio.ts`
- [Quiz domain models](https://github.com/guru071/friend_quiz/blob/main/src/types/quiz.ts): `src/types/quiz.ts`

### Firebase platform

- [Firebase setup](https://github.com/guru071/friend_quiz/blob/main/src/services/firebase.ts): `src/services/firebase.ts`
- **Firestore**

### Other components

- **Quiz user**

## Connections

- Quiz user → App coordinator: uses
- App coordinator → Navigation: renders (evidence: `src/App.tsx`)
- App coordinator → Quiz discovery: renders (evidence: `src/App.tsx`)
- App coordinator → Quiz creator: renders (evidence: `src/App.tsx`)
- App coordinator → Join quiz: renders (evidence: `src/App.tsx`)
- App coordinator → Quiz lobby: renders (evidence: `src/App.tsx`)
- App coordinator → Quiz player: renders (evidence: `src/App.tsx`)
- App coordinator → Quiz results: renders (evidence: `src/App.tsx`)
- App coordinator → Leaderboard: renders (evidence: `src/App.tsx`)
- App coordinator → Quiz sharing: renders (evidence: `src/App.tsx`)
- App coordinator → User profile: renders (evidence: `src/App.tsx`)
- App coordinator → Quiz data access: loads quiz (evidence: `src/App.tsx`)
- App coordinator → Badge awards: records awards (evidence: `src/App.tsx`)
- Quiz creator → Quiz data access: saves quiz (evidence: `src/components/QuizCreator.tsx`)
- Quiz player → Quiz data access: saves results (evidence: `src/components/QuizPlayer.tsx`)
- Quiz player → Quiz scoring: uses scoring (evidence: `src/components/QuizPlayer.tsx`)
- Quiz player → AI spell correction: requests correction (evidence: `src/components/QuizPlayer.tsx`)
- Quiz player → Sound effects: plays effects (evidence: `src/components/QuizPlayer.tsx`)
- Quiz data access → Firebase setup: uses setup (evidence: `src/services/firestoreService.ts`)
- Firebase setup → Firestore: connects (evidence: `src/services/firebase.ts`)
- Badge awards → Firestore: reads and writes (evidence: `src/services/badgeService.ts`)
- Badge awards → Quiz domain models: uses types (evidence: `src/services/badgeService.ts`)
- Quiz data access → Quiz domain models: uses types (evidence: `src/services/firestoreService.ts`)
