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 β¦