phyn2-2/kikuyu-vocab

Collaborative Kikuyu language learning platform built with Django # 🌍 Kikuyu Vocabulary Platform A collaborative language learning platform for preserving and teaching the Kikuyu language through community contributions. ## ✨ Features - 📚 **Browse Vocabulary** - Explore Kikuyu words with English translations - 🎵 **Audio Pronunciations** - Listen to native speakers - 🖼️ **Visual Context** - Images for better understanding - 🔍 **Advanced Search** - Filter by category, difficulty, language - 👥 **Community Driven** - Authenticated users can contribute - ✅ **Quality Control** - Admin approval workflow - 💬 **Discussions** - Comment on words and usage - ❤️ **Favorites** - Save words for later study - 📱 **Responsive Design** - Works on mobile and desktop ## 🎨 Design Custom **deep purple theme** with dark web aesthetic: - Mystical purple (#8b5cf6) accent colors - Smooth animations and hover effects - JetBrains Mono monospace font - Card-based layouts with gradients - Mobile-responsive design ## 🚀 Quick Start ### Prerequisites - Python 3.8+ - pip - virtualenv (recommended) ### Installation ```bash # Clone repository git clone github.com cd kikuyu-vocab-platform # Create virtual environment python -m venv myenv source myenv/bin/activate # Linux/Mac # myenv\Scripts\activate # Windows # Install dependencies pip install -r requirements.txt # Run migrations python manage.py migrate # Create superuser (admin account) python manage.py createsuperuser # Create categories (optional) python manage.py shell >>> from vocab.models import Category >>> Category.objects.create(name='Noun', icon='📦', description='People, places, things') >>> Category.objects.create(name='Verb', icon='⚡', description='Actions') >>> exit() # Collect static files python manage.py collectstatic --noinput # Run development server python manage.py runserver ``` Visit: **127.0.0.1 ## 🎯 Usage ### For Learners (Public) 1. Browse vocabulary at `/vocab/` 2. Search and filter words 3. Listen to pronunciati …