MichaelKarina/SmartNews-Kenya

````markdown # 📰 SmartNews Kenya 🇰🇪 **SmartNews Kenya** is a modern Flask web app that scrapes trending Swahili articles from top Kenyan news websites and displays them in a clean, categorized, and mobile-friendly interface. Built with Python, HTML, CSS, and JavaScript — this project aims to make it easier to access the latest verified local news. --- ## ✨ Features - 📰 Live news scraping from: - Tuko - Citizen Digital - Nation Africa - 🌙 Dark mode toggle - 🔥 Trending badges - 🧭 Filter by category (Politics, Entertainment, etc.) - 🖼️ OG image previews from article metadata - 🧑‍💼 Admin panel to manually post stories - 🎞️ Slideshow headline feature (in progress) - 📱 Responsive for mobile and desktop --- ## 🚀 Getting Started ### Prerequisites - Python 3.8+ - pip (Python package manager) - Git ### Installation ```bash # Clone the repository git clone github.com cd SmartNews-Kenya # Install dependencies pip install -r requirements.txt # Run the Flask app python main.py ```` Then open your browser and go to: `127.0.0.1` --- ## 📊 WakaTime Badge Style Customization You can customize the badge appearance by appending a `?style=` query: ```markdown ``` ### Supported styles: * `default` * `plastic` * `flat` * `flat-square` * `for-the-badge` * `social` --- ## 🛠️ Tech Stack * **Backend:** Flask (Python) * **Frontend:** HTML, CSS, JS * **Scraping:** Requests, BeautifulSoup * **Storage:** JSON (for local data), ready for DB upgrade --- ## 👨🏽‍💻 Author **Michael Karina** 📍 Kenya 🔗 GitHub Profile --- ## 📜 License This project is licensed under the MIT License. --- > SmartNews Kenya – Bringing verified news closer to Kenyans 🇰🇪 ``` --- ✅ Let me know if you'd like a `LICENSE`, `requirements.txt`, or a sample `main.py` to go with this `README.md`. ```