# bungisa/greeting architecture

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

- Interactive diagram: https://gitdiagram.com/bungisa/greeting
- Repository: https://github.com/bungisa/greeting

## Overview

Elimika is a curriculum-aligned learning app combining study tools, interactive science simulations, AI-assisted learning, and educational games. The main user journey starts in the app, where learners or teachers choose a learning activity; curriculum and question-bank services supply structured content, and the selected tool presents explanations, practice, or interactive play. Teachers can also build classroom games, while learners explore STEM activities and simulations. The graph follows relationships supported by the README and source index excerpts; many listed components were not sampled, so their internal calls and integrations are not inferred.

Main entry points: [`src/App.tsx`](https://github.com/bungisa/greeting/blob/main/src/App.tsx) (Elimika app), [`src/data/curriculumData.ts`](https://github.com/bungisa/greeting/blob/main/src/data/curriculumData.ts) (Curriculum data), [`src/games/gameDataAndStorage.ts`](https://github.com/bungisa/greeting/blob/main/src/games/gameDataAndStorage.ts) (Game content and progress), [`src/utils/questionBankManager.ts`](https://github.com/bungisa/greeting/blob/main/src/utils/questionBankManager.ts) (Question bank manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Learning app"]
  node_app["Elimika app<br/>[App.tsx]"]
  node_backend["AI and app server<br/>[server.ts]"]
end

subgraph group_content["Curriculum and questions"]
  node_curriculum[("Curriculum data<br/>[curriculumData.ts]")]
  node_textbookbank[("Extracted textbook bank")]
  node_questionbank["Question bank manager"]
  node_diagrams["Question diagrams"]
end

subgraph group_study["Study tools"]
  node_tie_generator["Scheme of work generator"]
  node_question_extractor["Textbook question extractor"]
  node_math_renderer["Math renderer<br/>[mathRenderer.ts]"]
end

subgraph group_sim["Simulations and STEM"]
  node_interactive_lab["Interactive diagram lab"]
  node_sim_hub["Simulations hub<br/>[SimulationsHub.tsx]"]
  node_virtual_lab["Virtual science lab"]
  node_stem_builder["STEM builder"]
  node_stem_curriculum[("STEM activity curriculum")]
  node_stem_viewport["Science lab viewport"]
end

subgraph group_games["Educational games"]
  node_play_hub["Elimika Play hub<br/>[ElimikaPlayHub.tsx]"]
  node_teacher_studio["Classroom game studio"]
  node_teacher_engine["Classroom game engine"]
  node_projector_board["Projector game board"]
  node_play_storage[("Game content and progress")]
  node_tie_engine["Textbook question engine"]
  node_treasure_game["Treasure hunt game"]
end

node_learner(("Learner or teacher"))
node_gemini{{"Google Gemini"}}

node_learner -->|"uses"| node_app
node_app -->|"opens"| node_interactive_lab
node_app -->|"opens"| node_sim_hub
node_app -->|"opens"| node_play_hub
node_app -->|"opens"| node_tie_generator
node_app -->|"opens"| node_question_extractor
node_app -->|"uses"| node_curriculum
node_app -->|"renders with"| node_math_renderer
node_app -->|"uses"| node_diagrams
node_sim_hub -->|"offers"| node_interactive_lab
node_sim_hub -->|"offers"| node_virtual_lab
node_virtual_lab -->|"renders with"| node_stem_viewport
node_stem_builder -->|"uses"| node_stem_curriculum
node_stem_builder -->|"renders with"| node_stem_viewport
node_tie_generator -->|"uses syllabi"| node_curriculum
node_question_extractor -->|"uses"| node_questionbank
node_question_extractor -->|"uses"| node_curriculum
node_questionbank -->|"reads"| node_textbookbank
node_curriculum -->|"reads"| node_textbookbank
node_diagrams -->|"uses diagrams"| node_curriculum
node_backend -->|"uses syllabus"| node_curriculum
node_backend -->|"calls"| node_gemini
node_play_hub -->|"offers"| node_teacher_studio
node_play_hub -->|"offers"| node_treasure_game
node_teacher_studio -->|"uses"| node_teacher_engine
node_teacher_studio -->|"opens"| node_projector_board
node_teacher_engine -->|"reads questions"| node_questionbank
node_teacher_engine -->|"uses"| node_play_storage
node_play_storage -->|"builds quizzes with"| node_curriculum
node_play_storage -->|"builds questions with"| node_tie_engine
node_tie_engine -->|"reads questions"| node_questionbank
node_treasure_game -->|"loads progress"| node_play_storage
node_treasure_game -->|"renders math"| node_math_renderer

click node_app "https://github.com/bungisa/greeting/blob/main/src/App.tsx"
click node_curriculum "https://github.com/bungisa/greeting/blob/main/src/data/curriculumData.ts"
click node_textbookbank "https://github.com/bungisa/greeting/blob/main/src/data/extractedTextbookExerciseBank.ts"
click node_questionbank "https://github.com/bungisa/greeting/blob/main/src/utils/questionBankManager.ts"
click node_diagrams "https://github.com/bungisa/greeting/blob/main/src/utils/questionDiagramGenerator.ts"
click node_backend "https://github.com/bungisa/greeting/blob/main/server.ts"
click node_interactive_lab "https://github.com/bungisa/greeting/blob/main/src/components/InteractiveDiagramLab.tsx"
click node_sim_hub "https://github.com/bungisa/greeting/blob/main/src/components/SimulationsHub.tsx"
click node_virtual_lab "https://github.com/bungisa/greeting/blob/main/src/components/VirtualScienceLab.tsx"
click node_stem_builder "https://github.com/bungisa/greeting/blob/main/src/games/stemBuilder/StemBuilderGame.tsx"
click node_stem_curriculum "https://github.com/bungisa/greeting/blob/main/src/games/stemBuilder/stemBuilderCurriculum.ts"
click node_stem_viewport "https://github.com/bungisa/greeting/blob/main/src/games/stemBuilder/ScienceLab3DViewport.tsx"
click node_tie_generator "https://github.com/bungisa/greeting/blob/main/src/components/TieSchemeOfWorkGenerator.tsx"
click node_question_extractor "https://github.com/bungisa/greeting/blob/main/src/components/TextbookQuestionExtractorModal.tsx"
click node_math_renderer "https://github.com/bungisa/greeting/blob/main/src/utils/mathRenderer.ts"
click node_play_hub "https://github.com/bungisa/greeting/blob/main/src/components/ElimikaPlayHub.tsx"
click node_teacher_studio "https://github.com/bungisa/greeting/blob/main/src/components/games/TeacherClassroomGameStudio.tsx"
click node_teacher_engine "https://github.com/bungisa/greeting/blob/main/src/games/teacherClassroomGameEngine.ts"
click node_projector_board "https://github.com/bungisa/greeting/blob/main/src/components/games/ProjectorClassroomGameBoard.tsx"
click node_play_storage "https://github.com/bungisa/greeting/blob/main/src/games/gameDataAndStorage.ts"
click node_tie_engine "https://github.com/bungisa/greeting/blob/main/src/games/tieTextbookQuestionEngine.ts"
click node_treasure_game "https://github.com/bungisa/greeting/blob/main/src/components/games/TreasureHuntGame.tsx"

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_backend toneBlue
class node_curriculum,node_textbookbank,node_questionbank,node_diagrams toneAmber
class node_tie_generator,node_question_extractor,node_math_renderer toneMint
class node_interactive_lab,node_sim_hub,node_virtual_lab,node_stem_builder,node_stem_curriculum,node_stem_viewport toneRose
class node_play_hub,node_teacher_studio,node_teacher_engine,node_projector_board,node_play_storage,node_tie_engine,node_treasure_game,node_learner,node_gemini toneIndigo
```

## Components

### Learning app

- [Elimika app](https://github.com/bungisa/greeting/blob/main/src/App.tsx): `src/App.tsx`
- [AI and app server](https://github.com/bungisa/greeting/blob/main/server.ts): `server.ts`

### Curriculum and questions

- [Curriculum data](https://github.com/bungisa/greeting/blob/main/src/data/curriculumData.ts): `src/data/curriculumData.ts`
- [Extracted textbook bank](https://github.com/bungisa/greeting/blob/main/src/data/extractedTextbookExerciseBank.ts): `src/data/extractedTextbookExerciseBank.ts`
- [Question bank manager](https://github.com/bungisa/greeting/blob/main/src/utils/questionBankManager.ts): `src/utils/questionBankManager.ts`
- [Question diagrams](https://github.com/bungisa/greeting/blob/main/src/utils/questionDiagramGenerator.ts): `src/utils/questionDiagramGenerator.ts`

### Study tools

- [Scheme of work generator](https://github.com/bungisa/greeting/blob/main/src/components/TieSchemeOfWorkGenerator.tsx): `src/components/TieSchemeOfWorkGenerator.tsx`
- [Textbook question extractor](https://github.com/bungisa/greeting/blob/main/src/components/TextbookQuestionExtractorModal.tsx): `src/components/TextbookQuestionExtractorModal.tsx`
- [Math renderer](https://github.com/bungisa/greeting/blob/main/src/utils/mathRenderer.ts): `src/utils/mathRenderer.ts`

### Simulations and STEM

- [Interactive diagram lab](https://github.com/bungisa/greeting/blob/main/src/components/InteractiveDiagramLab.tsx): `src/components/InteractiveDiagramLab.tsx`
- [Simulations hub](https://github.com/bungisa/greeting/blob/main/src/components/SimulationsHub.tsx): `src/components/SimulationsHub.tsx`
- [Virtual science lab](https://github.com/bungisa/greeting/blob/main/src/components/VirtualScienceLab.tsx): `src/components/VirtualScienceLab.tsx`
- [STEM builder](https://github.com/bungisa/greeting/blob/main/src/games/stemBuilder/StemBuilderGame.tsx): `src/games/stemBuilder/StemBuilderGame.tsx`
- [STEM activity curriculum](https://github.com/bungisa/greeting/blob/main/src/games/stemBuilder/stemBuilderCurriculum.ts): `src/games/stemBuilder/stemBuilderCurriculum.ts`
- [Science lab viewport](https://github.com/bungisa/greeting/blob/main/src/games/stemBuilder/ScienceLab3DViewport.tsx): `src/games/stemBuilder/ScienceLab3DViewport.tsx`

### Educational games

- [Elimika Play hub](https://github.com/bungisa/greeting/blob/main/src/components/ElimikaPlayHub.tsx): `src/components/ElimikaPlayHub.tsx`
- [Classroom game studio](https://github.com/bungisa/greeting/blob/main/src/components/games/TeacherClassroomGameStudio.tsx): `src/components/games/TeacherClassroomGameStudio.tsx`
- [Classroom game engine](https://github.com/bungisa/greeting/blob/main/src/games/teacherClassroomGameEngine.ts): `src/games/teacherClassroomGameEngine.ts`
- [Projector game board](https://github.com/bungisa/greeting/blob/main/src/components/games/ProjectorClassroomGameBoard.tsx): `src/components/games/ProjectorClassroomGameBoard.tsx`
- [Game content and progress](https://github.com/bungisa/greeting/blob/main/src/games/gameDataAndStorage.ts): `src/games/gameDataAndStorage.ts`
- [Textbook question engine](https://github.com/bungisa/greeting/blob/main/src/games/tieTextbookQuestionEngine.ts): `src/games/tieTextbookQuestionEngine.ts`
- [Treasure hunt game](https://github.com/bungisa/greeting/blob/main/src/components/games/TreasureHuntGame.tsx): `src/components/games/TreasureHuntGame.tsx`

### Other components

- **Learner or teacher**
- **Google Gemini**

## Connections

- Learner or teacher → Elimika app: uses
- Elimika app → Interactive diagram lab: opens (evidence: `src/App.tsx`)
- Elimika app → Simulations hub: opens (evidence: `src/App.tsx`)
- Elimika app → Elimika Play hub: opens (evidence: `src/App.tsx`)
- Elimika app → Scheme of work generator: opens (evidence: `src/App.tsx`)
- Elimika app → Textbook question extractor: opens (evidence: `src/App.tsx`)
- Elimika app → Curriculum data: uses (evidence: `src/App.tsx`)
- Elimika app → Math renderer: renders with (evidence: `src/App.tsx`)
- Elimika app → Question diagrams: uses (evidence: `src/App.tsx`)
- Simulations hub → Interactive diagram lab: offers (evidence: `src/components/SimulationsHub.tsx`)
- Simulations hub → Virtual science lab: offers (evidence: `src/components/SimulationsHub.tsx`)
- Virtual science lab → Science lab viewport: renders with (evidence: `src/components/VirtualScienceLab.tsx`)
- STEM builder → STEM activity curriculum: uses (evidence: `src/games/stemBuilder/StemBuilderGame.tsx`)
- STEM builder → Science lab viewport: renders with (evidence: `src/games/stemBuilder/StemBuilderGame.tsx`)
- Scheme of work generator → Curriculum data: uses syllabi (evidence: `src/components/TieSchemeOfWorkGenerator.tsx`)
- Textbook question extractor → Question bank manager: uses (evidence: `src/components/TextbookQuestionExtractorModal.tsx`)
- Textbook question extractor → Curriculum data: uses (evidence: `src/components/TextbookQuestionExtractorModal.tsx`)
- Question bank manager → Extracted textbook bank: reads (evidence: `src/utils/questionBankManager.ts`)
- Curriculum data → Extracted textbook bank: reads (evidence: `src/data/curriculumData.ts`)
- Question diagrams → Curriculum data: uses diagrams (evidence: `src/data/curriculumData.ts`)
- AI and app server → Curriculum data: uses syllabus (evidence: `server.ts`)
- AI and app server → Google Gemini: calls (evidence: `server.ts`)
- Elimika Play hub → Classroom game studio: offers (evidence: `src/components/ElimikaPlayHub.tsx`)
- Elimika Play hub → Treasure hunt game: offers (evidence: `src/components/ElimikaPlayHub.tsx`)
- Classroom game studio → Classroom game engine: uses (evidence: `src/components/games/TeacherClassroomGameStudio.tsx`)
- Classroom game studio → Projector game board: opens (evidence: `src/components/games/TeacherClassroomGameStudio.tsx`)
- Classroom game engine → Question bank manager: reads questions (evidence: `src/games/teacherClassroomGameEngine.ts`)
- Classroom game engine → Game content and progress: uses (evidence: `src/games/teacherClassroomGameEngine.ts`)
- Game content and progress → Curriculum data: builds quizzes with (evidence: `src/games/gameDataAndStorage.ts`)
- Game content and progress → Textbook question engine: builds questions with (evidence: `src/games/gameDataAndStorage.ts`)
- Textbook question engine → Question bank manager: reads questions (evidence: `src/games/tieTextbookQuestionEngine.ts`)
- Treasure hunt game → Game content and progress: loads progress (evidence: `src/components/games/TreasureHuntGame.tsx`)
- Treasure hunt game → Math renderer: renders math (evidence: `src/components/games/TreasureHuntGame.tsx`)
