DavidBugger/hausa-buddy

# 🗣️ HausaBuddy — Learn Hausa the Smart Way ## � Table of Contents - 🚀 Project Overview - 🎯 Core Objectives - 🧠 Key Features - 🧩 Tech Stack - 🗂️ Folder Structure - 🧱 Django Models Overview - 🔌 API Endpoints - ⚙️ Getting Started - 🧭 Roadmap - 🤝 Contributing - 💼 About the Project Lead - 🏆 License # �🗣️ HausaBuddy — Learn Hausa the Smart Way > **Empowering communication through technology and culture.** > HausaBuddy is an intelligent language learning platform designed to help users — especially corps members, travelers, and professionals — learn the **Hausa language** quickly and interactively through AI-powered features like **Text-to-Speech, Quizzes, Audio Lessons, and Chat-based Learning**. --- ## 🚀 Project Overview The **HausaBuddy App** is a mobile learning solution aimed at preserving and promoting the Hausa language while making it accessible to a global audience. Built with **Flutter (for mobile)** and **Django (for backend APIs)**, the app combines **AI** and **linguistic data** to deliver a modern, engaging, and culturally rich learning experience. --- ## 🎯 Core Objectives - Bridge the communication gap for non-Hausa speakers living or working in Northern Nigeria. - Digitize and preserve the Hausa dialect in an engaging, mobile-first format. - Provide **AI-assisted conversational practice** to accelerate real-life fluency. - Support offline learning for users in low-connectivity areas. --- ## 🧠 Key Features | Feature | Description | |----------|-------------| | 🔑 **User Authentication** | Secure sign up & login using email or Google OAuth. | | 📚 **Lessons Module** | Structured lessons with native pronunciations & translations. | | 🔊 **Audio Playback** | Learn correct pronunciation through text-to-speech. | | 🧩 **Quizzes & Assessments** | Reinforce learning through interactive tests. | | 💬 **AI Chat Tutor** | Engage in real-time Hausa conversation practice. | | 🔖 **Bookmarks & Progress Tracking** | Save favorite words & track learning milest …