README.md
# 🐄 Taphad'Meuh — Français ↔ Afaan Oromoo
> **FR** Application bilingue d'apprentissage · **EN** Bilingual learning app · **OR** Appii barachuu afaan lama · **AM** መተግበሪያ ሁለት ቋንቋ
---
## 🇫🇷 Français
Application web progressive (PWA) pour apprendre le Français ou l'Afaan Oromoo — gratuite, sans inscription, 100 % hors-ligne après la première visite. Zéro dépendance, zéro framework.
## 🇬🇧 English
Progressive Web App (PWA) to learn French or Afaan Oromoo — free, no sign-up, 100% offline after first visit. Zero dependency, zero framework.
## 🇪🇹 Afaan Oromoo
Appii web (PWA) Faransaayii yookiin Afaan Oromoo barachuuf — bilisaa, galmee malee, interneetii malee yeroo hundaa hojjeta. Hirmaannaa yookiin framework hin barbaachisu.
## 🇪🇹 አማርኛ (Amharic)
ፕሮግረሲቭ ዌብ አፕ (PWA) ፈረንሳይኛ ወይም አፋን ኦሮሞ ለመማር — ነፃ፣ ምዝገባ አያስፈልግም፣ ከመጀመሪያ ጉብኝት በኋላ ሙሉ በሙሉ ከመስመር ውጭ ይሰራል።
---
## 📁 Architecture
```
Taphad'Meuh/
│
├── index.html ← Unique entry point — 4 screens + 2 modals (no logic)
│
├── css/
│ └── style.css ← All styles — dual theme system (theme-french / theme-oromo)
│
├── js/
│ ├── app.js ← Full application engine (5 905 lines, 21 sections)
│ ├── data-fr.js ← Dataset — "Learn French" mode (48 themes, 1 428 lines)
│ └── data-or.js ← Dataset — "Learn Oromo" mode (48 themes, 1 383 lines)
│
├── sw.js ← Service Worker — Cache First / Network First + SVG fallbacks
├── manifest.json ← PWA manifest — icons, theme colors, orientation
│
├── img/
│ ├── Logo-appli-or-fr.png
│ └── icons/
│ └── icon-*.png ← PWA icons (72 → 512 px, maskable variants)
```
---
## 🔄 User flow
```
[Launcher] → choose language
│
▼
[Home] → dashboard + bilingual explanatory guide, ONE merged screen
(dashboard: Start/Continue button + progress card(s) ;
guide: accordions, reachable any time via 📚/Guide nav)
│
▼
[Sections] → grid of 48 modules (Niveau 1 ×32 + Niveau 2 ×16)
│
▼
[Lesson] → tab …