AbdurahmanHussein/KnowHub_Ethiopia

A platform for Ethiopian students to discover schools, scholarships, test prep guides, skills, and opportunities — all in one place. # KnowHub Ethiopia 🇪🇹 Welcome to **KnowHub Ethiopia**, a premium, modern, and highly responsive web application designed for both normal desktop/mobile browsers and as a **Telegram Mini App**. Our mission is to empower Ethiopian students by providing free, centralized access to schools, scholarships, test preparation guides, study resources, and academic opportunities. --- ## ✨ Features - **📱 Dual Mode Support**: Seamlessly integrates with the Telegram Mini App SDK with graceful fallback for regular web browsers. - **🎨 Modern Premium UI/UX**: Vibrant, harmonious color schemes with glassmorphism, custom scrollbars, and smooth micro-animations. - **⚡ Built for Speed**: Powered by Vite and React 19 for instantaneous page loads and lightning-fast navigation. - **📊 Real-time Stats**: Track 45+ Schools, 120+ Scholarships, 80+ Key Opportunities, and 200+ Free Courses. - **📚 Curated Resources**: Comprehensive sections for IELTS/TOEFL preparation, study materials, and AI-powered tutoring. - **🤖 AI Study Assistant**: Google Gemini-powered AI tutor available 24/7 (requires API key setup). - **🔐 Secure Authentication**: Email/password auth via Supabase with session management. - **⭐ User Features**: Bookmarks, likes, comments, admin panel for content management. - **🎯 100% Free**: Built entirely to support student journeys without registrations or hidden fees. --- ## 🛠️ Technology Stack - **Core Framework**: React 19 - **Bundler & Dev Server**: Vite 8 - **Icons**: Lucide React - **Backend**: Supabase (PostgreSQL + Auth) - **AI Tutor**: Google Gemini API - **Styling**: Pure vanilla CSS with custom variables, smooth transitions, modular layout. - **Platform Integration**: Telegram WebApp SDK (for mini-app functionality) - **Deployment**: Vercel (serverless functions for `/api/tutor`) --- ## 🚀 Getting Started ### 📋 Prerequisites - **Node.js** (v18 or higher) - **npm** (v8+) - **Supabase Project** (free tier available at supabase.com) - **Google Gemini API Key** (option …