# danilo1228/app-ingles architecture

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

- Interactive diagram: https://gitdiagram.com/danilo1228/app-ingles
- Repository: https://github.com/danilo1228/app-ingles

## Overview

English Path is a self-contained A2–C2 English-learning web app. Learners take a placement test, study level-based lessons and vocabulary, practise listening, reading, speaking and writing, and track progress through daily tasks, scheduled reviews and exams. The graph preserves the documented immersion, pronunciation and Cambridge-mock branches alongside the core course. Source excerpts show selected app behavior; relationships for unsampled features are included only where the README documents them.

Main entry points: [`src/app.js`](https://github.com/danilo1228/app-ingles/blob/main/src/app.js) (Learning app), [`src/app2.js`](https://github.com/danilo1228/app-ingles/blob/main/src/app2.js) (Additional modules), [`src/config.js`](https://github.com/danilo1228/app-ingles/blob/main/src/config.js) (Supabase settings), [`src/content.js`](https://github.com/danilo1228/app-ingles/blob/main/src/content.js) (Core course)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["App experience"]
  node_app["Learning app<br/>[app.js]"]
  node_modules["Additional modules<br/>[app2.js]"]
end

subgraph group_course["Course content"]
  node_coursebase["Core course<br/>[content.js]"]
  node_a2["A2 content<br/>[a2.js]"]
  node_b1["B1 content<br/>[b1.js]"]
  node_b2["B2 content<br/>[b2.js]"]
  node_c1["C1 content<br/>[c1.js]"]
  node_c2["C2 content<br/>[c2.js]"]
  node_vocab["Extra vocabulary<br/>[vocab_more.js]"]
end

subgraph group_practice["Practice extensions"]
  node_irregular["Irregular verbs<br/>[irregular.js]"]
  node_pron["Pronunciation units<br/>[pron.js]"]
  node_mocks["Cambridge mocks<br/>[mocks.js]"]
  node_immguide["Immersion guide<br/>[immersion_guide.js]"]
  node_resources["Immersion resources<br/>[resources.js]"]
end

subgraph group_state["Progress and services"]
  node_progress["Progress and sync<br/>[app.js]"]
  node_config["Supabase settings<br/>[config.js]"]
  node_schema[("Progress schema<br/>[schema.sql]")]
end

node_learner(("Learner"))
node_languagetool{{"LanguageTool"}}
node_dictionary{{"Free Dictionary API"}}
node_mymemory{{"MyMemory"}}

node_learner -->|"uses"| node_app
node_app -->|"serves lessons"| node_coursebase
node_app -->|"serves level content"| node_a2
node_app -->|"serves level content"| node_b1
node_app -->|"serves level content"| node_b2
node_app -->|"serves level content"| node_c1
node_app -->|"serves level content"| node_c2
node_app -->|"uses vocabulary"| node_vocab
node_app -->|"offers practice"| node_irregular
node_app -->|"offers practice"| node_pron
node_modules -->|"presents mocks"| node_mocks
node_modules -->|"presents guide"| node_immguide
node_modules -->|"presents resources"| node_resources
node_app -->|"updates progress"| node_progress
node_progress -.->|"uses settings"| node_config
node_config -.->|"configures sync"| node_schema
node_app -.->|"checks writing"| node_languagetool
node_modules -.->|"looks up words"| node_dictionary
node_modules -->|"translates text"| node_mymemory

click node_app "https://github.com/danilo1228/app-ingles/blob/main/src/app.js"
click node_modules "https://github.com/danilo1228/app-ingles/blob/main/src/app2.js"
click node_coursebase "https://github.com/danilo1228/app-ingles/blob/main/src/content.js"
click node_a2 "https://github.com/danilo1228/app-ingles/blob/main/src/levels/a2.js"
click node_b1 "https://github.com/danilo1228/app-ingles/blob/main/src/levels/b1.js"
click node_b2 "https://github.com/danilo1228/app-ingles/blob/main/src/levels/b2.js"
click node_c1 "https://github.com/danilo1228/app-ingles/blob/main/src/levels/c1.js"
click node_c2 "https://github.com/danilo1228/app-ingles/blob/main/src/levels/c2.js"
click node_vocab "https://github.com/danilo1228/app-ingles/blob/main/src/extras/vocab_more.js"
click node_irregular "https://github.com/danilo1228/app-ingles/blob/main/src/extras/irregular.js"
click node_pron "https://github.com/danilo1228/app-ingles/blob/main/src/extras/pron.js"
click node_mocks "https://github.com/danilo1228/app-ingles/blob/main/src/extras/mocks.js"
click node_immguide "https://github.com/danilo1228/app-ingles/blob/main/src/extras/immersion_guide.js"
click node_resources "https://github.com/danilo1228/app-ingles/blob/main/src/extras/resources.js"
click node_progress "https://github.com/danilo1228/app-ingles/blob/main/src/app.js"
click node_config "https://github.com/danilo1228/app-ingles/blob/main/src/config.js"
click node_schema "https://github.com/danilo1228/app-ingles/blob/main/supabase/schema.sql"

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_modules toneBlue
class node_coursebase,node_a2,node_b1,node_b2,node_c1,node_c2,node_vocab toneAmber
class node_irregular,node_pron,node_mocks,node_immguide,node_resources,node_dictionary toneMint
class node_progress,node_config,node_schema toneRose
class node_learner,node_languagetool,node_mymemory toneIndigo
```

## Components

### App experience

- [Learning app](https://github.com/danilo1228/app-ingles/blob/main/src/app.js): `src/app.js`
- [Additional modules](https://github.com/danilo1228/app-ingles/blob/main/src/app2.js): `src/app2.js`

### Course content

- [Core course](https://github.com/danilo1228/app-ingles/blob/main/src/content.js): `src/content.js`
- [A2 content](https://github.com/danilo1228/app-ingles/blob/main/src/levels/a2.js): `src/levels/a2.js`
- [B1 content](https://github.com/danilo1228/app-ingles/blob/main/src/levels/b1.js): `src/levels/b1.js`
- [B2 content](https://github.com/danilo1228/app-ingles/blob/main/src/levels/b2.js): `src/levels/b2.js`
- [C1 content](https://github.com/danilo1228/app-ingles/blob/main/src/levels/c1.js): `src/levels/c1.js`
- [C2 content](https://github.com/danilo1228/app-ingles/blob/main/src/levels/c2.js): `src/levels/c2.js`
- [Extra vocabulary](https://github.com/danilo1228/app-ingles/blob/main/src/extras/vocab_more.js): `src/extras/vocab_more.js`

### Practice extensions

- [Irregular verbs](https://github.com/danilo1228/app-ingles/blob/main/src/extras/irregular.js): `src/extras/irregular.js`
- [Pronunciation units](https://github.com/danilo1228/app-ingles/blob/main/src/extras/pron.js): `src/extras/pron.js`
- [Cambridge mocks](https://github.com/danilo1228/app-ingles/blob/main/src/extras/mocks.js): `src/extras/mocks.js`
- [Immersion guide](https://github.com/danilo1228/app-ingles/blob/main/src/extras/immersion_guide.js): `src/extras/immersion_guide.js`
- [Immersion resources](https://github.com/danilo1228/app-ingles/blob/main/src/extras/resources.js): `src/extras/resources.js`

### Progress and services

- [Progress and sync](https://github.com/danilo1228/app-ingles/blob/main/src/app.js): `src/app.js`
- [Supabase settings](https://github.com/danilo1228/app-ingles/blob/main/src/config.js): `src/config.js`
- [Progress schema](https://github.com/danilo1228/app-ingles/blob/main/supabase/schema.sql): `supabase/schema.sql`

### Other components

- **Learner**
- **LanguageTool**
- **Free Dictionary API**
- **MyMemory**

## Connections

- Learner → Learning app: uses (evidence: `README.md`)
- Learning app → Core course: serves lessons (evidence: `README.md`)
- Learning app → A2 content: serves level content (evidence: `README.md`)
- Learning app → B1 content: serves level content (evidence: `README.md`)
- Learning app → B2 content: serves level content (evidence: `README.md`)
- Learning app → C1 content: serves level content (evidence: `README.md`)
- Learning app → C2 content: serves level content (evidence: `README.md`)
- Learning app → Extra vocabulary: uses vocabulary (evidence: `README.md`)
- Learning app → Irregular verbs: offers practice (evidence: `README.md`)
- Learning app → Pronunciation units: offers practice (evidence: `README.md`)
- Additional modules → Cambridge mocks: presents mocks (evidence: `src/app2.js`)
- Additional modules → Immersion guide: presents guide (evidence: `README.md`)
- Additional modules → Immersion resources: presents resources (evidence: `README.md`)
- Learning app → Progress and sync: updates progress (evidence: `src/app.js`)
- Progress and sync → Supabase settings: uses settings
- Supabase settings → Progress schema: configures sync
- Learning app → LanguageTool: checks writing (evidence: `README.md`)
- Additional modules → Free Dictionary API: looks up words (evidence: `README.md`)
- Additional modules → MyMemory: translates text (evidence: `src/app2.js`)
