# illyadd/justlearnapp architecture

> Architecture diagram of the GitHub repository illyadd/justlearnapp, 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/illyadd/justlearnapp
- Repository: https://github.com/illyadd/justlearnapp

## Overview

JustLearn is a SwiftUI vocabulary-learning app. Users onboard, manage words and tags, then practice with flashcards or typed translations; study progress is persisted and synchronized to a companion watch app. The graph includes the documented settings and reminder capabilities. Some UI and view-model implementations were not excerpted, so those relationships are shown only where the README or SOURCE INDEX supports them; watch connectivity and SwiftData behavior are grounded in the sampled source.

Main entry points: [`JustLearn/App/JustLearnApp.swift`](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/App/JustLearnApp.swift) (App entry), [`JustLearn/App/ContentView.swift`](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/App/ContentView.swift) (Main tabs), [`JustLearn/Core/Persistence/WordService.swift`](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Core/Persistence/WordService.swift) (Word service), [`JustLearn/Features/Settings/SettingsView.swift`](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/Settings/SettingsView.swift) (Settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_app_entry["App entry<br/>[JustLearnApp.swift]"]
  node_onboarding["Onboarding"]
  node_main_tabs["Main tabs<br/>[ContentView.swift]"]
  node_settings["Settings<br/>[SettingsView.swift]"]
  node_settings_logic["Settings logic"]
end

subgraph group_words["Vocabulary management"]
  node_word_list["Word list<br/>[WordListView.swift]"]
  node_word_editors["Word editors"]
  node_validation["Word validation"]
  node_tag_management["Tag management"]
end

subgraph group_practice["Learning practice"]
  node_cards["Flashcards<br/>[CardView.swift]"]
  node_writing["Writing practice<br/>[WritingView.swift]"]
  node_practice_session["Session logic"]
end

subgraph group_platform["Persistence and platform"]
  node_word_service["Word service<br/>[WordService.swift]"]
  node_word_models["Word and tag models<br/>[Words.swift]"]
  node_notifications["Reminder service"]
  node_watch_sync["Phone sync"]
  node_watch_app["Watch app"]
  node_watch_receiver["Watch receiver"]
  node_swiftdata[("SwiftData store")]
end

node_learner(("Learner"))

node_learner -->|"opens app"| node_app_entry
node_app_entry -->|"shows first"| node_onboarding
node_app_entry -->|"shows after setup"| node_main_tabs
node_main_tabs -->|"opens tab"| node_word_list
node_main_tabs -->|"opens tab"| node_cards
node_main_tabs -->|"opens tab"| node_writing
node_main_tabs -->|"opens tab"| node_settings
node_word_list -->|"presents editors"| node_word_editors
node_word_editors -->|"validates fields"| node_validation
node_word_list -->|"updates words"| node_word_service
node_settings -->|"opens manager"| node_tag_management
node_settings -->|"delegates settings"| node_settings_logic
node_settings_logic -->|"schedules reminders"| node_notifications
node_cards -->|"uses session"| node_practice_session
node_writing -->|"uses session"| node_practice_session
node_practice_session -->|"records study"| node_word_service
node_app_entry -->|"creates service"| node_word_service
node_app_entry -->|"creates container"| node_swiftdata
node_word_service -->|"saves changes"| node_swiftdata
node_word_service -->|"syncs updates"| node_watch_sync
node_watch_sync -->|"fetches words"| node_word_models
node_watch_sync -.->|"sends word context"| node_watch_receiver
node_watch_receiver -->|"applies updates"| node_swiftdata
node_watch_app -->|"activates receiver"| node_watch_receiver

click node_app_entry "https://github.com/illyadd/justlearnapp/blob/main/JustLearn/App/JustLearnApp.swift"
click node_onboarding "https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/Onboarding/OnBoardingView.swift"
click node_main_tabs "https://github.com/illyadd/justlearnapp/blob/main/JustLearn/App/ContentView.swift"
click node_word_list "https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/WordList/WordListView.swift"
click node_word_editors "https://github.com/illyadd/justlearnapp/tree/main/JustLearn/Features/WordList"
click node_validation "https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Core/Models/WordValidation.swift"
click node_tag_management "https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/TagsManagement/TagsManagementView.swift"
click node_cards "https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/Practice/Cards/CardView.swift"
click node_writing "https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/Practice/Writing/WritingView.swift"
click node_practice_session "https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/Practice/PracticeSessionViewModel.swift"
click node_settings "https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/Settings/SettingsView.swift"
click node_settings_logic "https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/Settings/SettingsViewModel.swift"
click node_word_service "https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Core/Persistence/WordService.swift"
click node_word_models "https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Core/Models/Words.swift"
click node_notifications "https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Core/Notifications/NotificationService.swift"
click node_watch_sync "https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Core/Sync/WatchSyncManager.swift"
click node_watch_app "https://github.com/illyadd/justlearnapp/blob/main/JustLearnWatch%20Watch%20App/WatchContentView.swift"
click node_watch_receiver "https://github.com/illyadd/justlearnapp/blob/main/JustLearnWatch%20Watch%20App/PhoneSyncReceiver.swift"

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_entry,node_onboarding,node_main_tabs,node_settings,node_settings_logic toneBlue
class node_word_list,node_word_editors,node_validation,node_tag_management toneAmber
class node_cards,node_writing,node_practice_session toneMint
class node_word_service,node_word_models,node_notifications,node_watch_sync,node_watch_app,node_watch_receiver,node_swiftdata toneRose
class node_learner toneIndigo
```

## Components

### App experience

- [App entry](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/App/JustLearnApp.swift): `JustLearn/App/JustLearnApp.swift`
- [Onboarding](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/Onboarding/OnBoardingView.swift): `JustLearn/Features/Onboarding/OnBoardingView.swift`
- [Main tabs](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/App/ContentView.swift): `JustLearn/App/ContentView.swift`
- [Settings](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/Settings/SettingsView.swift): `JustLearn/Features/Settings/SettingsView.swift`
- [Settings logic](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/Settings/SettingsViewModel.swift): `JustLearn/Features/Settings/SettingsViewModel.swift`

### Vocabulary management

- [Word list](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/WordList/WordListView.swift): `JustLearn/Features/WordList/WordListView.swift`
- [Word editors](https://github.com/illyadd/justlearnapp/tree/main/JustLearn/Features/WordList): `JustLearn/Features/WordList`
- [Word validation](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Core/Models/WordValidation.swift): `JustLearn/Core/Models/WordValidation.swift`
- [Tag management](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/TagsManagement/TagsManagementView.swift): `JustLearn/Features/TagsManagement/TagsManagementView.swift`

### Learning practice

- [Flashcards](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/Practice/Cards/CardView.swift): `JustLearn/Features/Practice/Cards/CardView.swift`
- [Writing practice](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/Practice/Writing/WritingView.swift): `JustLearn/Features/Practice/Writing/WritingView.swift`
- [Session logic](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Features/Practice/PracticeSessionViewModel.swift): `JustLearn/Features/Practice/PracticeSessionViewModel.swift`

### Persistence and platform

- [Word service](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Core/Persistence/WordService.swift): `JustLearn/Core/Persistence/WordService.swift`
- [Word and tag models](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Core/Models/Words.swift): `JustLearn/Core/Models/Words.swift`
- [Reminder service](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Core/Notifications/NotificationService.swift): `JustLearn/Core/Notifications/NotificationService.swift`
- [Phone sync](https://github.com/illyadd/justlearnapp/blob/main/JustLearn/Core/Sync/WatchSyncManager.swift): `JustLearn/Core/Sync/WatchSyncManager.swift`
- [Watch app](https://github.com/illyadd/justlearnapp/blob/main/JustLearnWatch%20Watch%20App/WatchContentView.swift): `JustLearnWatch Watch App/WatchContentView.swift`
- [Watch receiver](https://github.com/illyadd/justlearnapp/blob/main/JustLearnWatch%20Watch%20App/PhoneSyncReceiver.swift): `JustLearnWatch Watch App/PhoneSyncReceiver.swift`
- **SwiftData store**

### Other components

- **Learner**

## Connections

- Learner → App entry: opens app
- App entry → Onboarding: shows first (evidence: `JustLearn/App/JustLearnApp.swift`)
- App entry → Main tabs: shows after setup (evidence: `JustLearn/App/JustLearnApp.swift`)
- Main tabs → Word list: opens tab (evidence: `JustLearn/App/ContentView.swift`)
- Main tabs → Flashcards: opens tab (evidence: `JustLearn/App/ContentView.swift`)
- Main tabs → Writing practice: opens tab (evidence: `JustLearn/App/ContentView.swift`)
- Main tabs → Settings: opens tab (evidence: `JustLearn/App/ContentView.swift`)
- Word list → Word editors: presents editors (evidence: `JustLearn/Features/WordList/WordListView.swift`)
- Word editors → Word validation: validates fields (evidence: `JustLearn/Features/WordList/AddWordSheet.swift`)
- Word list → Word service: updates words (evidence: `JustLearn/Features/WordList/WordListView.swift`)
- Settings → Tag management: opens manager (evidence: `JustLearn/Features/Settings/SettingsView.swift`)
- Settings → Settings logic: delegates settings (evidence: `JustLearn/Features/Settings/SettingsView.swift`)
- Settings logic → Reminder service: schedules reminders (evidence: `JustLearn/Features/Settings/SettingsViewModel.swift`)
- Flashcards → Session logic: uses session (evidence: `JustLearn/Features/Practice/Cards/CardView.swift`)
- Writing practice → Session logic: uses session (evidence: `JustLearn/Features/Practice/Writing/WritingView.swift`)
- Session logic → Word service: records study (evidence: `JustLearn/Features/Practice/PracticeSessionViewModel.swift`)
- App entry → Word service: creates service (evidence: `JustLearn/App/JustLearnApp.swift`)
- App entry → SwiftData store: creates container (evidence: `JustLearn/App/JustLearnApp.swift`)
- Word service → SwiftData store: saves changes (evidence: `JustLearn/Core/Persistence/WordService.swift`)
- Word service → Phone sync: syncs updates (evidence: `JustLearn/Core/Persistence/WordService.swift`)
- Phone sync → Word and tag models: fetches words (evidence: `JustLearn/Core/Sync/WatchSyncManager.swift`)
- Phone sync → Watch receiver: sends word context
- Watch receiver → SwiftData store: applies updates (evidence: `JustLearnWatch Watch App/PhoneSyncReceiver.swift`)
- Watch app → Watch receiver: activates receiver
