LingoLearn AI helps students translate English textbook content into Hausa, Igbo, Yoruba, and Nigerian Pidgin using AI-powered OCR, contextual translation, and voice output.
# 🎓 LingoLearn AI
### Educational Equity App · Abuja, Nigeria
> *"Your textbook, explained in your language."*
LingoLearn AI helps students translate English textbook content into **Hausa, Igbo, Yoruba, and Nigerian Pidgin** using AI-powered OCR, contextual translation, and voice output.
---
## 📱 App Features
| Feature | Description |
|--------|-------------|
| 📸 **Camera Scan** | Full-screen camera with scan frame overlay |
| 🔍 **AI OCR** | Extracts text from textbook photos using GPT-4o-mini |
| 🧠 **Smart Simplification** | Rewrites content in Big Brother/Sister tutor style |
| 🌍 **4 Languages** | Hausa, Igbo, Yoruba, Nigerian Pidgin |
| 🔊 **Voice Output** | Google Cloud TTS reads explanations aloud |
| 📡 **Data-Lite Mode** | Images compressed to ~150KB before API call |
---
## 🗂️ Project Structure
```
LingoLearnAI/
├── App.js # Root: Navigation setup (Stack: Home → Camera → Results)
├── app.json # Expo config (permissions, icons, splash)
├── package.json # Dependencies
├── babel.config.js # Babel + env vars
├── .env.example # API key template (copy to .env)
│
└── src/
├── theme/
│ └── index.js # Colors, Typography, Spacing, Shadows, Language config
│
├── screens/
│ ├── HomeScreen.js # Landing page + Scan Now CTA + language picker
│ ├── CameraScreen.js # Full-screen camera with scan frame + flash control
│ └── ResultsScreen.js # OCR results + translated explanation + TTS
│
├── components/
│ └── LanguagePicker.js # Animated horizontal pill-style language selector
│
├── services/
│ ├── apiService.js # Gemini: OCR + translation logic
│ └── ttsService.js # Google Cloud TTS + Expo AV playback
│
└── utils/
└── imageOptimizer.js # Resize + JPEG compress photos (Data-Lite strategy)
```
---
## 🚀 Getting Started
### Prerequisites
- Node.js 18+
- Expo CLI: `npm install -g expo-cli`
- Expo Go app on your A …