# masterofalphabet/challenges architecture

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

- Interactive diagram: https://gitdiagram.com/masterofalphabet/challenges
- Repository: https://github.com/masterofalphabet/challenges

## Overview

This is a mobile English-learning app for students, with learning modules, skill tests, multiplayer battles, challenges, and dashboards. The principal learner flow is navigation from the app into a learning or test screen, through practice, and— for diagnostic tests—into results. Firebase supports authentication and battle data; daily challenge attempts and test-session results also have local state. The README is empty, so capability coverage comes from the file tree and source index. Several screens are unsampled; their edges are included only where the index identifies a dependency or App.js routes to them.

Main entry points: [`App.js`](https://github.com/masterofalphabet/challenges/blob/main/App.js) (App Navigator), [`src/screens/TestYourSkillsScreen.js`](https://github.com/masterofalphabet/challenges/blob/main/src/screens/TestYourSkillsScreen.js) (Skills Test), [`src/components/DailyChallenge.js`](https://github.com/masterofalphabet/challenges/blob/main/src/components/DailyChallenge.js) (Daily Challenge), [`firebase.js`](https://github.com/masterofalphabet/challenges/blob/main/firebase.js) (Firebase Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Navigation"]
  node_app["App Navigator<br/>[App.js]"]
  node_home["Home<br/>[HomeScreen.js]"]
end

subgraph group_learning["Learning Modules"]
  node_grammar["Grammar<br/>[GrammarScreen.js]"]
  node_learning_screen["Learning Guide<br/>[LearningScreen.js]"]
  node_listening["Listening<br/>[ListeningScreen.js]"]
  node_pronunciation["Pronunciation"]
  node_reading["Reading<br/>[ReadingScreen.js]"]
  node_sharp["S.H.A.R.P.<br/>[SharpScreen.js]"]
  node_spelling["Spelling<br/>[SpellingScreen.js]"]
  node_vocabulary["Vocabulary"]
  node_writing["Writing<br/>[WritingScreen.js]"]
end

subgraph group_assessment["Assessment &amp; Progress"]
  node_test["Skills Test"]
  node_practice["Practice Skills"]
  node_skill_details["Skill Analysis"]
  node_test_questions["Test Questions"]
  node_session["Test Session<br/>[session.js]"]
end

subgraph group_engagement["Challenges &amp; Battles"]
  node_battles["Quiz Battles<br/>[Battles.js]"]
  node_battle_questions["Battle Questions<br/>[battleQuestions.js]"]
  node_daily_challenge["Daily Challenge<br/>[DailyChallenge.js]"]
  node_challenge_data["Challenge Content<br/>[challenges.js]"]
end

subgraph group_services["Data &amp; Services"]
  node_attempts["Attempt History<br/>[attempts.js]"]
  node_streak["Streak Tracker<br/>[streak.js]"]
  node_firebase["Firebase Client<br/>[firebase.js]"]
  node_auth_service["Authentication Service<br/>[authService.js]"]
  node_firebase_config["Auth Configuration<br/>[firebaseConfig.js]"]
end

node_learner(("Learner"))
node_firestore[("Firebase Services")]

node_learner -->|"opens"| node_app
node_app -->|"routes"| node_home
node_app -->|"routes"| node_grammar
node_app -->|"routes"| node_learning_screen
node_app -->|"routes"| node_listening
node_app -->|"routes"| node_pronunciation
node_app -->|"routes"| node_reading
node_app -->|"routes"| node_sharp
node_app -->|"routes"| node_spelling
node_app -->|"routes"| node_vocabulary
node_app -->|"routes"| node_writing
node_app -->|"routes"| node_test
node_app -->|"routes"| node_battles
node_app -->|"routes"| node_daily_challenge
node_home -->|"uses"| node_firebase
node_practice -->|"loads"| node_test_questions
node_test -->|"loads"| node_test_questions
node_test -->|"uses"| node_firebase
node_test -->|"records results"| node_session
node_skill_details -->|"reads results"| node_session
node_battles -->|"loads"| node_battle_questions
node_battles -->|"reads and writes"| node_firebase
node_daily_challenge -->|"loads"| node_challenge_data
node_daily_challenge -->|"saves attempts"| node_attempts
node_daily_challenge -->|"updates streak"| node_streak
node_firebase -->|"initializes"| node_firestore
node_auth_service -->|"imports"| node_firebase_config

click node_app "https://github.com/masterofalphabet/challenges/blob/main/App.js"
click node_home "https://github.com/masterofalphabet/challenges/blob/main/src/screens/HomeScreen.js"
click node_grammar "https://github.com/masterofalphabet/challenges/blob/main/src/screens/GrammarScreen.js"
click node_learning_screen "https://github.com/masterofalphabet/challenges/blob/main/src/screens/LearningScreen.js"
click node_listening "https://github.com/masterofalphabet/challenges/blob/main/src/screens/ListeningScreen.js"
click node_pronunciation "https://github.com/masterofalphabet/challenges/blob/main/src/screens/PronunciationScreen.js"
click node_reading "https://github.com/masterofalphabet/challenges/blob/main/src/screens/ReadingScreen.js"
click node_sharp "https://github.com/masterofalphabet/challenges/blob/main/src/screens/SharpScreen.js"
click node_spelling "https://github.com/masterofalphabet/challenges/blob/main/src/screens/SpellingScreen.js"
click node_vocabulary "https://github.com/masterofalphabet/challenges/blob/main/src/screens/VocabularyScreen.js"
click node_writing "https://github.com/masterofalphabet/challenges/blob/main/src/screens/WritingScreen.js"
click node_test "https://github.com/masterofalphabet/challenges/blob/main/src/screens/TestYourSkillsScreen.js"
click node_practice "https://github.com/masterofalphabet/challenges/blob/main/src/screens/PracticeSkillsScreen.js"
click node_skill_details "https://github.com/masterofalphabet/challenges/blob/main/src/screens/ModuleSkillAnalysisDetailsScreen.js"
click node_test_questions "https://github.com/masterofalphabet/challenges/blob/main/src/data/testYourSkillsQuestionsData.js"
click node_session "https://github.com/masterofalphabet/challenges/blob/main/src/services/session.js"
click node_battles "https://github.com/masterofalphabet/challenges/blob/main/src/screens/Battles.js"
click node_battle_questions "https://github.com/masterofalphabet/challenges/blob/main/src/data/battleQuestions.js"
click node_daily_challenge "https://github.com/masterofalphabet/challenges/blob/main/src/components/DailyChallenge.js"
click node_challenge_data "https://github.com/masterofalphabet/challenges/blob/main/src/data/challenges.js"
click node_attempts "https://github.com/masterofalphabet/challenges/blob/main/src/utils/attempts.js"
click node_streak "https://github.com/masterofalphabet/challenges/blob/main/src/utils/streak.js"
click node_firebase "https://github.com/masterofalphabet/challenges/blob/main/firebase.js"
click node_auth_service "https://github.com/masterofalphabet/challenges/blob/main/src/services/authService.js"
click node_firebase_config "https://github.com/masterofalphabet/challenges/blob/main/src/services/firebaseConfig.js"

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_home toneBlue
class node_grammar,node_learning_screen,node_listening,node_pronunciation,node_reading,node_sharp,node_spelling,node_vocabulary,node_writing,node_firestore toneAmber
class node_test,node_practice,node_skill_details,node_test_questions,node_session toneMint
class node_battles,node_battle_questions,node_daily_challenge,node_challenge_data toneRose
class node_attempts,node_streak,node_firebase,node_auth_service,node_firebase_config,node_learner toneIndigo
```

## Components

### App Navigation

- [App Navigator](https://github.com/masterofalphabet/challenges/blob/main/App.js): `App.js`
- [Home](https://github.com/masterofalphabet/challenges/blob/main/src/screens/HomeScreen.js): `src/screens/HomeScreen.js`

### Learning Modules

- [Grammar](https://github.com/masterofalphabet/challenges/blob/main/src/screens/GrammarScreen.js): `src/screens/GrammarScreen.js`
- [Learning Guide](https://github.com/masterofalphabet/challenges/blob/main/src/screens/LearningScreen.js): `src/screens/LearningScreen.js`
- [Listening](https://github.com/masterofalphabet/challenges/blob/main/src/screens/ListeningScreen.js): `src/screens/ListeningScreen.js`
- [Pronunciation](https://github.com/masterofalphabet/challenges/blob/main/src/screens/PronunciationScreen.js): `src/screens/PronunciationScreen.js`
- [Reading](https://github.com/masterofalphabet/challenges/blob/main/src/screens/ReadingScreen.js): `src/screens/ReadingScreen.js`
- [S.H.A.R.P.](https://github.com/masterofalphabet/challenges/blob/main/src/screens/SharpScreen.js): `src/screens/SharpScreen.js`
- [Spelling](https://github.com/masterofalphabet/challenges/blob/main/src/screens/SpellingScreen.js): `src/screens/SpellingScreen.js`
- [Vocabulary](https://github.com/masterofalphabet/challenges/blob/main/src/screens/VocabularyScreen.js): `src/screens/VocabularyScreen.js`
- [Writing](https://github.com/masterofalphabet/challenges/blob/main/src/screens/WritingScreen.js): `src/screens/WritingScreen.js`

### Assessment & Progress

- [Skills Test](https://github.com/masterofalphabet/challenges/blob/main/src/screens/TestYourSkillsScreen.js): `src/screens/TestYourSkillsScreen.js`
- [Practice Skills](https://github.com/masterofalphabet/challenges/blob/main/src/screens/PracticeSkillsScreen.js): `src/screens/PracticeSkillsScreen.js`
- [Skill Analysis](https://github.com/masterofalphabet/challenges/blob/main/src/screens/ModuleSkillAnalysisDetailsScreen.js): `src/screens/ModuleSkillAnalysisDetailsScreen.js`
- [Test Questions](https://github.com/masterofalphabet/challenges/blob/main/src/data/testYourSkillsQuestionsData.js): `src/data/testYourSkillsQuestionsData.js`
- [Test Session](https://github.com/masterofalphabet/challenges/blob/main/src/services/session.js): `src/services/session.js`

### Challenges & Battles

- [Quiz Battles](https://github.com/masterofalphabet/challenges/blob/main/src/screens/Battles.js): `src/screens/Battles.js`
- [Battle Questions](https://github.com/masterofalphabet/challenges/blob/main/src/data/battleQuestions.js): `src/data/battleQuestions.js`
- [Daily Challenge](https://github.com/masterofalphabet/challenges/blob/main/src/components/DailyChallenge.js): `src/components/DailyChallenge.js`
- [Challenge Content](https://github.com/masterofalphabet/challenges/blob/main/src/data/challenges.js): `src/data/challenges.js`

### Data & Services

- [Attempt History](https://github.com/masterofalphabet/challenges/blob/main/src/utils/attempts.js): `src/utils/attempts.js`
- [Streak Tracker](https://github.com/masterofalphabet/challenges/blob/main/src/utils/streak.js): `src/utils/streak.js`
- [Firebase Client](https://github.com/masterofalphabet/challenges/blob/main/firebase.js): `firebase.js`
- [Authentication Service](https://github.com/masterofalphabet/challenges/blob/main/src/services/authService.js): `src/services/authService.js`
- [Auth Configuration](https://github.com/masterofalphabet/challenges/blob/main/src/services/firebaseConfig.js): `src/services/firebaseConfig.js`

### Other components

- **Learner**
- **Firebase Services**

## Connections

- Learner → App Navigator: opens
- App Navigator → Home: routes (evidence: `App.js`)
- App Navigator → Grammar: routes (evidence: `App.js`)
- App Navigator → Learning Guide: routes (evidence: `App.js`)
- App Navigator → Listening: routes (evidence: `App.js`)
- App Navigator → Pronunciation: routes (evidence: `App.js`)
- App Navigator → Reading: routes (evidence: `App.js`)
- App Navigator → S.H.A.R.P.: routes (evidence: `App.js`)
- App Navigator → Spelling: routes (evidence: `App.js`)
- App Navigator → Vocabulary: routes (evidence: `App.js`)
- App Navigator → Writing: routes (evidence: `App.js`)
- App Navigator → Skills Test: routes (evidence: `App.js`)
- App Navigator → Quiz Battles: routes (evidence: `App.js`)
- App Navigator → Daily Challenge: routes (evidence: `App.js`)
- Home → Firebase Client: uses (evidence: `src/screens/HomeScreen.js`)
- Practice Skills → Test Questions: loads (evidence: `src/screens/PracticeSkillsScreen.js`)
- Skills Test → Test Questions: loads (evidence: `src/screens/TestYourSkillsScreen.js`)
- Skills Test → Firebase Client: uses (evidence: `src/screens/TestYourSkillsScreen.js`)
- Skills Test → Test Session: records results
- Skill Analysis → Test Session: reads results
- Quiz Battles → Battle Questions: loads (evidence: `src/screens/Battles.js`)
- Quiz Battles → Firebase Client: reads and writes (evidence: `src/screens/Battles.js`)
- Daily Challenge → Challenge Content: loads (evidence: `src/components/DailyChallenge.js`)
- Daily Challenge → Attempt History: saves attempts (evidence: `src/components/DailyChallenge.js`)
- Daily Challenge → Streak Tracker: updates streak (evidence: `src/components/DailyChallenge.js`)
- Firebase Client → Firebase Services: initializes (evidence: `firebase.js`)
- Authentication Service → Auth Configuration: imports (evidence: `src/services/authService.js`)
