CyberSDG/dholuo-platform

# Dholuo.learn > A modern, open-source platform for learning Dholuo — built by the community, for the community. Dholuo (also called Luo) is the language of the Luo people of Kenya and East Africa. It carries centuries of culture, identity, and oral tradition. Yet many young Luo people today — especially those growing up in cities or in the diaspora — are losing fluency, not because they don't care, but because there has never been a modern, accessible way to learn it. **Dholuo.learn** is changing that. --- ## Features - **Dictionary** — Search thousands of Dholuo words with English meanings, example sentences, part of speech, regional variants, and cultural context - **Flashcard Practice** — Spaced-repetition drills that adapt to what you know - **Structured Lessons** — Beginner to advanced content grouped by topic: greetings, numbers, family, food, daily life - **Live Translator** — English ↔ Dholuo translation powered by Google Translate - **AI Conversation Partner** — Practice real Dholuo conversation with an AI that teaches as you go - **Community Contributions** — Anyone can submit a missing word, fix a translation, or add an example sentence --- ## Tech Stack | Layer | Technology | |-------|-----------| | Frontend | React 18 + TypeScript + Vite | | Styling | Tailwind CSS | | Backend | Node.js + Express + TypeScript | | Database | PostgreSQL | | Translation | Google Cloud Translation API | | Deployment | Render (backend) + Supabase (DB) + Vercel (frontend) | --- ## Getting Started ### Prerequisites - Node.js 18+ - PostgreSQL 14+ - Python 3.10+ (for PDF data extraction only) ### 1. Clone the repository ```bash git clone github.com cd dholuo-platform ``` ### 2. Install dependencies ```bash # Install all dependencies (root, server, and client) npm run install:all ``` Or install separately: ```bash cd server && npm install cd ../client && npm install ``` ### 3. Set up the database Create a PostgreSQL databa …