# freerss2/vox_libera architecture

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

## Overview

Vox-Libera is an offline-first language-learning app: learners choose a course, study topic content, and practice it through interactive exercises. The README describes vocabulary, phrases, exercises, and progression to the next topic; the sampled app excerpt shows exercise interactions, while course files hold lesson content and translations. The map also includes UI localization, settings, and narrator support. Source excerpts do not establish most runtime wiring, so relationships are limited to visible calls and documented behavior; unsampled integrations are omitted.

Main entry points: [`js/main.js`](https://github.com/freerss2/vox_libera/blob/main/js/main.js) (Course selection), [`js/app.js`](https://github.com/freerss2/vox_libera/blob/main/js/app.js) (Vocabulary), [`course.ar1/lessons.js`](https://github.com/freerss2/vox_libera/blob/main/course.ar1/lessons.js) (Arabic course), [`course.he1/lessons.js`](https://github.com/freerss2/vox_libera/blob/main/course.he1/lessons.js) (Hebrew course)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Course entry"]
  node_home["Course selection<br/>[main.js]"]
end

subgraph group_learning["Learning experience"]
  node_vocabulary["Vocabulary<br/>[app.js]"]
  node_phrases["Phrases<br/>[app.js]"]
  node_exercises["Interactive exercises<br/>[app.js]"]
  node_topic_navigation["Topic navigation<br/>[app.js]"]
end

subgraph group_content["Course content"]
  node_arabic["Arabic course<br/>[lessons.js]"]
  node_hebrew["Hebrew course<br/>[lessons.js]"]
  node_course_locales_ar["Arabic translations<br/>[locales.js]"]
  node_course_locales_he["Hebrew translations<br/>[locales.js]"]
end

subgraph group_support["App services"]
  node_settings["Study settings<br/>[settings.js]"]
  node_ui_i18n["UI localization<br/>[i18n.js]"]
  node_shared_ui["Shared UI services<br/>[common.js]"]
  node_sync["Google sync<br/>[google_sync.js]"]
end

node_learner(("Learner"))
node_tts["Device speech engine"]

node_learner -->|"chooses course"| node_home
node_home -->|"opens course page"| node_arabic
node_home -->|"opens course page"| node_hebrew
node_learner -->|"studies words"| node_vocabulary
node_learner -->|"studies phrases"| node_phrases
node_learner -->|"practices material"| node_exercises
node_learner -->|"continues topics"| node_topic_navigation
node_home -->|"creates settings"| node_settings
node_home -->|"creates translator"| node_ui_i18n
node_home -->|"calls narrator helpers"| node_shared_ui
node_learner -.->|"requests speech"| node_tts

click node_home "https://github.com/freerss2/vox_libera/blob/main/js/main.js"
click node_arabic "https://github.com/freerss2/vox_libera/blob/main/course.ar1/lessons.js"
click node_hebrew "https://github.com/freerss2/vox_libera/blob/main/course.he1/lessons.js"
click node_course_locales_ar "https://github.com/freerss2/vox_libera/blob/main/course.ar1/locales.js"
click node_course_locales_he "https://github.com/freerss2/vox_libera/blob/main/course.he1/locales.js"
click node_vocabulary "https://github.com/freerss2/vox_libera/blob/main/js/app.js"
click node_phrases "https://github.com/freerss2/vox_libera/blob/main/js/app.js"
click node_exercises "https://github.com/freerss2/vox_libera/blob/main/js/app.js"
click node_topic_navigation "https://github.com/freerss2/vox_libera/blob/main/js/app.js"
click node_settings "https://github.com/freerss2/vox_libera/blob/main/js/settings.js"
click node_ui_i18n "https://github.com/freerss2/vox_libera/blob/main/js/i18n.js"
click node_shared_ui "https://github.com/freerss2/vox_libera/blob/main/js/common.js"
click node_sync "https://github.com/freerss2/vox_libera/blob/main/js/google_sync.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_home toneBlue
class node_vocabulary,node_phrases,node_exercises,node_topic_navigation toneAmber
class node_arabic,node_hebrew,node_course_locales_ar,node_course_locales_he toneMint
class node_settings,node_ui_i18n,node_shared_ui,node_sync toneRose
class node_learner,node_tts toneIndigo
```

## Components

### Course entry

- [Course selection](https://github.com/freerss2/vox_libera/blob/main/js/main.js): `js/main.js`

### Learning experience

- [Vocabulary](https://github.com/freerss2/vox_libera/blob/main/js/app.js): `js/app.js`
- [Phrases](https://github.com/freerss2/vox_libera/blob/main/js/app.js): `js/app.js`
- [Interactive exercises](https://github.com/freerss2/vox_libera/blob/main/js/app.js): `js/app.js`
- [Topic navigation](https://github.com/freerss2/vox_libera/blob/main/js/app.js): `js/app.js`

### Course content

- [Arabic course](https://github.com/freerss2/vox_libera/blob/main/course.ar1/lessons.js): `course.ar1/lessons.js`
- [Hebrew course](https://github.com/freerss2/vox_libera/blob/main/course.he1/lessons.js): `course.he1/lessons.js`
- [Arabic translations](https://github.com/freerss2/vox_libera/blob/main/course.ar1/locales.js): `course.ar1/locales.js`
- [Hebrew translations](https://github.com/freerss2/vox_libera/blob/main/course.he1/locales.js): `course.he1/locales.js`

### App services

- [Study settings](https://github.com/freerss2/vox_libera/blob/main/js/settings.js): `js/settings.js`
- [UI localization](https://github.com/freerss2/vox_libera/blob/main/js/i18n.js): `js/i18n.js`
- [Shared UI services](https://github.com/freerss2/vox_libera/blob/main/js/common.js): `js/common.js`
- [Google sync](https://github.com/freerss2/vox_libera/blob/main/js/google_sync.js): `js/google_sync.js`

### Other components

- **Learner**
- **Device speech engine**

## Connections

- Learner → Course selection: chooses course (evidence: `js/main.js`)
- Course selection → Arabic course: opens course page (evidence: `js/main.js`)
- Course selection → Hebrew course: opens course page (evidence: `js/main.js`)
- Learner → Vocabulary: studies words (evidence: `README.md`)
- Learner → Phrases: studies phrases (evidence: `README.md`)
- Learner → Interactive exercises: practices material (evidence: `README.md`)
- Learner → Topic navigation: continues topics (evidence: `README.md`)
- Course selection → Study settings: creates settings (evidence: `js/main.js`)
- Course selection → UI localization: creates translator (evidence: `js/main.js`)
- Course selection → Shared UI services: calls narrator helpers (evidence: `js/main.js`)
- Learner → Device speech engine: requests speech (evidence: `README.md`)
