Abebe-Biru/oduu

Odeessa: Every Ethiopian News platform in one place. # ODEESSA — Ethiopian News Hub 📰🇪🇹 **ODEESSA** is a modern, bilingual **Progressive Web App (PWA)** that aggregates Ethiopian news from major media outlets in both **Amharic (አማርኛ)** and **Afaan Oromoo** into a single, beautiful, distraction-free interface. **🔗 Live API:** ethio-news-api.onrender.com --- ## ✨ Features | Feature | Description | |---------|-------------| | 🌍 **Bilingual Support** | Switch between **አማርኛ** and **Afaan Oromoo** with one tap. Full UI translation. | | ⚡ **Real-time Aggregation** | Scrapes and consolidates news from 6+ Ethiopian sources every 4 hours. | | 📱 **PWA Ready** | Installable on mobile & desktop with full offline support. | | 🌙 **Dark / Light Mode** | Automatic OS detection with manual toggle. | | 🔍 **Smart Filters** | Filter by source, date range, keywords, and articles per page. | | 🔖 **Bookmarks** | Save articles locally for later reading. | | 🤖 **OduuBot AI** | AI-powered chatbot that answers questions about on-screen news with citations. | | 💾 **Persistent Preferences** | Language, time range, and display settings saved across sessions. | | 🎨 **Responsive Design** | Optimized for mobile, tablet, and desktop. | --- ## 📡 News Sources ### Amharic (አማርኛ) | Source | Type | |--------|------| | BBC Amharic | RSS | | ENA Amharic | HTML | | FANA Amharic | HTML | ### Afaan Oromoo | Source | Type | |--------|------| | BBC Afaan Oromoo | RSS | | ENA Afaan Oromoo | HTML | | FANA Afaan Oromoo | HTML | --- ## 🛠️ Tech Stack | Layer | Technologies | |-------|-------------| | **Frontend** | HTML5, Vanilla JS, Tailwind CSS, Lucide Icons, Noto Sans Ethiopic | | **Backend API** | Node.js, Express.js (API Repo) | | **Database** | SQLite (via Sequelize) | | **Scraping** | Cheerio, RSS Parser | | **Hosting** | Render.com (API), Static (Frontend) | --- ## 🏁 Quick Start ### Prerequisites - **Node.js** v18+ installed - The backend API running locally or using the hosted version ### 1. Clone & Open ```bash git clone github.c …