# kea335/kotlin_info_app architecture

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

- Interactive diagram: https://gitdiagram.com/kea335/kotlin_info_app
- Repository: https://github.com/kea335/kotlin_info_app

## Overview

KotlinAZ is an offline-first native Android Kotlin-learning app. Users browse lessons and code examples, practice theory and coding exercises, take quizzes, search course content, and use an online playground to run Kotlin code. Compose navigation routes screens through a shared ViewModel; bundled JSON supplies the learning material, while preferences retain settings and learning progress. The README documents additional interactive demonstrations and the offline content model. Relationships below follow shown imports/calls or README statements; unsampled implementation details are not inferred.

Main entry points: [`app/src/main/java/az/kotlinaz/app/ui/AppRoot.kt`](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/AppRoot.kt) (Compose navigation), [`app/src/main/java/az/kotlinaz/app/ui/AppViewModel.kt`](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/AppViewModel.kt) (App ViewModel), [`app/src/main/java/az/kotlinaz/app/data/KotlinCompiler.kt`](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/data/KotlinCompiler.kt) (Compiler client), [`app/src/main/java/az/kotlinaz/app/ui/editor/KodRedaktoru.kt`](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/editor/KodRedaktoru.kt) (Code editor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_activity["Android activity<br/>[MainActivity.kt]"]
  node_navigation["Compose navigation<br/>[AppRoot.kt]"]
  node_viewmodel["App ViewModel<br/>[AppViewModel.kt]"]
  node_settings["Settings<br/>[SettingsScreen.kt]"]
end

subgraph group_learning["Learning content"]
  node_lessons["Lessons<br/>[LessonsScreen.kt]"]
  node_lesson_detail["Lesson detail"]
  node_block_renderer["Content renderer<br/>[BlockRenderer.kt]"]
  node_code_card["Code examples<br/>[CodeCard.kt]"]
  node_demos["Interactive demos"]
  node_search_screen["Search screen<br/>[SearchScreen.kt]"]
end

subgraph group_practice["Practice tools"]
  node_exercises["Exercise topics<br/>[ExercisesScreen.kt]"]
  node_exercise_player["Exercise player"]
  node_quiz["Knowledge quiz<br/>[QuizScreen.kt]"]
  node_playground["Code playground"]
  node_editor["Code editor<br/>[KodRedaktoru.kt]"]
  node_completion["Word completion<br/>[Tamamlama.kt]"]
  node_highlighter["Syntax highlighter"]
  node_compiler["Compiler client<br/>[KotlinCompiler.kt]"]
end

subgraph group_data["Data and progress"]
  node_assets["Bundled content"]
  node_repository["Content repository"]
  node_models["Content models<br/>[Models.kt]"]
  node_prefs[("User preferences<br/>[UserPrefs.kt]")]
  node_progress["Progress rules<br/>[Tereqqi.kt]"]
  node_searchengine["Search engine<br/>[AxtarisMotoru.kt]"]
  node_versions["Compiler versions"]
end

node_learner(("Learner"))
node_compiler_service{{"JetBrains compiler"}}

node_learner -->|"opens"| node_activity
node_activity -->|"creates"| node_viewmodel
node_activity -->|"hosts"| node_navigation
node_navigation -->|"routes state"| node_viewmodel
node_navigation -->|"routes to"| node_lessons
node_navigation -->|"routes to"| node_lesson_detail
node_navigation -->|"routes to"| node_exercises
node_navigation -->|"routes to"| node_exercise_player
node_navigation -->|"routes to"| node_quiz
node_navigation -->|"routes to"| node_playground
node_navigation -->|"routes to"| node_search_screen
node_navigation -->|"routes to"| node_settings
node_viewmodel -->|"loads content"| node_repository
node_repository -->|"reads JSON"| node_assets
node_repository -->|"decodes as"| node_models
node_viewmodel -->|"reads and writes"| node_prefs
node_viewmodel -->|"searches with"| node_searchengine
node_viewmodel -->|"prepares"| node_compiler
node_viewmodel -->|"uses progress"| node_progress
node_lessons -->|"shows progress"| node_progress
node_lesson_detail -->|"renders blocks"| node_block_renderer
node_block_renderer -->|"renders code"| node_code_card
node_block_renderer -->|"hosts demos"| node_demos
node_exercise_player -->|"runs code"| node_compiler
node_playground -->|"runs code"| node_compiler
node_exercise_player -->|"edits code"| node_editor
node_playground -->|"edits code"| node_editor
node_editor -->|"offers words"| node_completion
node_editor -->|"colors syntax"| node_highlighter
node_compiler -->|"selects version"| node_versions
node_compiler -->|"caches versions"| node_prefs
node_compiler -->|"executes remotely"| node_compiler_service
node_search_screen -->|"requests search"| node_viewmodel
node_settings -->|"changes settings"| node_viewmodel

click node_activity "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/MainActivity.kt"
click node_navigation "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/AppRoot.kt"
click node_viewmodel "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/AppViewModel.kt"
click node_assets "https://github.com/kea335/kotlin_info_app/tree/main/app/src/main/assets"
click node_repository "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/data/ContentRepository.kt"
click node_models "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/data/model/Models.kt"
click node_prefs "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/data/UserPrefs.kt"
click node_progress "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/data/Tereqqi.kt"
click node_searchengine "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/data/AxtarisMotoru.kt"
click node_lessons "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/screens/LessonsScreen.kt"
click node_lesson_detail "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/screens/LessonDetailScreen.kt"
click node_block_renderer "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/components/BlockRenderer.kt"
click node_code_card "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/components/CodeCard.kt"
click node_demos "https://github.com/kea335/kotlin_info_app/tree/main/app/src/main/java/az/kotlinaz/app/ui/demos"
click node_exercises "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/screens/ExercisesScreen.kt"
click node_exercise_player "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/screens/ExercisePlayerScreen.kt"
click node_quiz "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/screens/QuizScreen.kt"
click node_playground "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/screens/PlaygroundScreen.kt"
click node_editor "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/editor/KodRedaktoru.kt"
click node_completion "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/editor/Tamamlama.kt"
click node_highlighter "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/highlight/KotlinHighlighter.kt"
click node_compiler "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/data/KotlinCompiler.kt"
click node_versions "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/data/KompilyatorVersiyalari.kt"
click node_search_screen "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/screens/SearchScreen.kt"
click node_settings "https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/screens/SettingsScreen.kt"

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_activity,node_navigation,node_viewmodel,node_settings toneBlue
class node_lessons,node_lesson_detail,node_block_renderer,node_code_card,node_demos,node_search_screen toneAmber
class node_exercises,node_exercise_player,node_quiz,node_playground,node_editor,node_completion,node_highlighter,node_compiler toneMint
class node_assets,node_repository,node_models,node_prefs,node_progress,node_searchengine,node_versions toneRose
class node_learner,node_compiler_service toneIndigo
```

## Components

### App shell

- [Android activity](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/MainActivity.kt): `app/src/main/java/az/kotlinaz/app/MainActivity.kt`
- [Compose navigation](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/AppRoot.kt): `app/src/main/java/az/kotlinaz/app/ui/AppRoot.kt`
- [App ViewModel](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/AppViewModel.kt): `app/src/main/java/az/kotlinaz/app/ui/AppViewModel.kt`
- [Settings](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/screens/SettingsScreen.kt): `app/src/main/java/az/kotlinaz/app/ui/screens/SettingsScreen.kt`

### Learning content

- [Lessons](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/screens/LessonsScreen.kt): `app/src/main/java/az/kotlinaz/app/ui/screens/LessonsScreen.kt`
- [Lesson detail](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/screens/LessonDetailScreen.kt): `app/src/main/java/az/kotlinaz/app/ui/screens/LessonDetailScreen.kt`
- [Content renderer](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/components/BlockRenderer.kt): `app/src/main/java/az/kotlinaz/app/ui/components/BlockRenderer.kt`
- [Code examples](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/components/CodeCard.kt): `app/src/main/java/az/kotlinaz/app/ui/components/CodeCard.kt`
- [Interactive demos](https://github.com/kea335/kotlin_info_app/tree/main/app/src/main/java/az/kotlinaz/app/ui/demos): `app/src/main/java/az/kotlinaz/app/ui/demos`
- [Search screen](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/screens/SearchScreen.kt): `app/src/main/java/az/kotlinaz/app/ui/screens/SearchScreen.kt`

### Practice tools

- [Exercise topics](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/screens/ExercisesScreen.kt): `app/src/main/java/az/kotlinaz/app/ui/screens/ExercisesScreen.kt`
- [Exercise player](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/screens/ExercisePlayerScreen.kt): `app/src/main/java/az/kotlinaz/app/ui/screens/ExercisePlayerScreen.kt`
- [Knowledge quiz](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/screens/QuizScreen.kt): `app/src/main/java/az/kotlinaz/app/ui/screens/QuizScreen.kt`
- [Code playground](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/screens/PlaygroundScreen.kt): `app/src/main/java/az/kotlinaz/app/ui/screens/PlaygroundScreen.kt`
- [Code editor](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/editor/KodRedaktoru.kt): `app/src/main/java/az/kotlinaz/app/ui/editor/KodRedaktoru.kt`
- [Word completion](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/editor/Tamamlama.kt): `app/src/main/java/az/kotlinaz/app/ui/editor/Tamamlama.kt`
- [Syntax highlighter](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/ui/highlight/KotlinHighlighter.kt): `app/src/main/java/az/kotlinaz/app/ui/highlight/KotlinHighlighter.kt`
- [Compiler client](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/data/KotlinCompiler.kt): `app/src/main/java/az/kotlinaz/app/data/KotlinCompiler.kt`

### Data and progress

- [Bundled content](https://github.com/kea335/kotlin_info_app/tree/main/app/src/main/assets): `app/src/main/assets`
- [Content repository](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/data/ContentRepository.kt): `app/src/main/java/az/kotlinaz/app/data/ContentRepository.kt`
- [Content models](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/data/model/Models.kt): `app/src/main/java/az/kotlinaz/app/data/model/Models.kt`
- [User preferences](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/data/UserPrefs.kt): `app/src/main/java/az/kotlinaz/app/data/UserPrefs.kt`
- [Progress rules](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/data/Tereqqi.kt): `app/src/main/java/az/kotlinaz/app/data/Tereqqi.kt`
- [Search engine](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/data/AxtarisMotoru.kt): `app/src/main/java/az/kotlinaz/app/data/AxtarisMotoru.kt`
- [Compiler versions](https://github.com/kea335/kotlin_info_app/blob/main/app/src/main/java/az/kotlinaz/app/data/KompilyatorVersiyalari.kt): `app/src/main/java/az/kotlinaz/app/data/KompilyatorVersiyalari.kt`

### Other components

- **Learner**
- **JetBrains compiler**

## Connections

- Learner → Android activity: opens (evidence: `README.md`)
- Android activity → App ViewModel: creates (evidence: `app/src/main/java/az/kotlinaz/app/MainActivity.kt`)
- Android activity → Compose navigation: hosts (evidence: `app/src/main/java/az/kotlinaz/app/MainActivity.kt`)
- Compose navigation → App ViewModel: routes state (evidence: `app/src/main/java/az/kotlinaz/app/ui/AppRoot.kt`)
- Compose navigation → Lessons: routes to (evidence: `app/src/main/java/az/kotlinaz/app/ui/AppRoot.kt`)
- Compose navigation → Lesson detail: routes to (evidence: `app/src/main/java/az/kotlinaz/app/ui/AppRoot.kt`)
- Compose navigation → Exercise topics: routes to (evidence: `app/src/main/java/az/kotlinaz/app/ui/AppRoot.kt`)
- Compose navigation → Exercise player: routes to (evidence: `app/src/main/java/az/kotlinaz/app/ui/AppRoot.kt`)
- Compose navigation → Knowledge quiz: routes to (evidence: `app/src/main/java/az/kotlinaz/app/ui/AppRoot.kt`)
- Compose navigation → Code playground: routes to (evidence: `app/src/main/java/az/kotlinaz/app/ui/AppRoot.kt`)
- Compose navigation → Search screen: routes to (evidence: `app/src/main/java/az/kotlinaz/app/ui/AppRoot.kt`)
- Compose navigation → Settings: routes to (evidence: `app/src/main/java/az/kotlinaz/app/ui/AppRoot.kt`)
- App ViewModel → Content repository: loads content (evidence: `app/src/main/java/az/kotlinaz/app/ui/AppViewModel.kt`)
- Content repository → Bundled content: reads JSON (evidence: `app/src/main/java/az/kotlinaz/app/data/ContentRepository.kt`)
- Content repository → Content models: decodes as (evidence: `app/src/main/java/az/kotlinaz/app/data/ContentRepository.kt`)
- App ViewModel → User preferences: reads and writes (evidence: `app/src/main/java/az/kotlinaz/app/ui/AppViewModel.kt`)
- App ViewModel → Search engine: searches with (evidence: `app/src/main/java/az/kotlinaz/app/ui/AppViewModel.kt`)
- App ViewModel → Compiler client: prepares (evidence: `app/src/main/java/az/kotlinaz/app/ui/AppViewModel.kt`)
- App ViewModel → Progress rules: uses progress (evidence: `app/src/main/java/az/kotlinaz/app/ui/AppViewModel.kt`)
- Lessons → Progress rules: shows progress (evidence: `app/src/main/java/az/kotlinaz/app/ui/screens/LessonsScreen.kt`)
- Lesson detail → Content renderer: renders blocks (evidence: `README.md`)
- Content renderer → Code examples: renders code (evidence: `app/src/main/java/az/kotlinaz/app/ui/components/BlockRenderer.kt`)
- Content renderer → Interactive demos: hosts demos (evidence: `app/src/main/java/az/kotlinaz/app/ui/components/BlockRenderer.kt`)
- Exercise player → Compiler client: runs code (evidence: `app/src/main/java/az/kotlinaz/app/ui/screens/ExercisePlayerScreen.kt`)
- Code playground → Compiler client: runs code (evidence: `app/src/main/java/az/kotlinaz/app/ui/screens/PlaygroundScreen.kt`)
- Exercise player → Code editor: edits code (evidence: `app/src/main/java/az/kotlinaz/app/ui/screens/ExercisePlayerScreen.kt`)
- Code playground → Code editor: edits code (evidence: `app/src/main/java/az/kotlinaz/app/ui/screens/PlaygroundScreen.kt`)
- Code editor → Word completion: offers words (evidence: `app/src/main/java/az/kotlinaz/app/ui/editor/KodRedaktoru.kt`)
- Code editor → Syntax highlighter: colors syntax (evidence: `app/src/main/java/az/kotlinaz/app/ui/editor/KodRedaktoru.kt`)
- Compiler client → Compiler versions: selects version (evidence: `app/src/main/java/az/kotlinaz/app/data/KotlinCompiler.kt`)
- Compiler client → User preferences: caches versions (evidence: `app/src/main/java/az/kotlinaz/app/data/KotlinCompiler.kt`)
- Compiler client → JetBrains compiler: executes remotely (evidence: `README.md`)
- Search screen → App ViewModel: requests search (evidence: `app/src/main/java/az/kotlinaz/app/ui/screens/SearchScreen.kt`)
- Settings → App ViewModel: changes settings (evidence: `app/src/main/java/az/kotlinaz/app/ui/AppRoot.kt`)
