https://github.com/akarshjha03/headlinehub
Your central hub for breaking news. A modern Android News App that fetches real-time headlines with a sleek and user-friendly UI.
https://github.com/akarshjha03/headlinehub
coil kotlin newsapi-org retrofit2-kotlin toast xml
Last synced: 21 days ago
JSON representation
Your central hub for breaking news. A modern Android News App that fetches real-time headlines with a sleek and user-friendly UI.
- Host: GitHub
- URL: https://github.com/akarshjha03/headlinehub
- Owner: Akarshjha03
- License: mit
- Created: 2025-02-14T05:09:42.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-04-03T18:08:24.000Z (about 1 year ago)
- Last Synced: 2025-04-03T19:23:35.506Z (about 1 year ago)
- Topics: coil, kotlin, newsapi-org, retrofit2-kotlin, toast, xml
- Language: Kotlin
- Homepage:
- Size: 1.29 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# 📰 News App
🚀 A modern **Android News App** that fetches real-time headlines with a sleek and user-friendly UI. Built using **Kotlin**, **Retrofit**, and **Coil** to provide a seamless news browsing experience!
---
## ✨ Key Features
✅ **Real-time News Fetching** – Retrieves top headlines, including images, titles, and descriptions, using **Retrofit** for API integration.
✅ **Swipe-to-Refresh** – Seamlessly refresh news content with **SwipeRefreshLayout**.
✅ **Dark Mode** 🌙 – Supports a **light/dark theme** for better readability and user comfort.
✅ **Material Design UI** 🎨 – Uses **MaterialCardView** to create an intuitive and responsive interface with **RecyclerView**.
✅ **Efficient Image Loading** 📷 – Integrated **Coil** for fast and memory-efficient image handling.
✅ **Error Handling & Feedback** ⚠️ – Displays **Toast messages** for real-time feedback on errors.
---
## 🛠️ Tech Stack
- **Kotlin** – For modern and concise Android development.
- **Retrofit + Gson** – For making API calls and parsing JSON responses.
- **Coil** – For fast and smooth image loading.
- **RecyclerView** – To display news articles in a scrollable list.
- **SwipeRefreshLayout** – For pull-to-refresh functionality.
- **NewsAPI** – Fetches up-to-date news articles from various sources.
---
## 🚀 Future Enhancements
- 🔍 **Search & Filter** – Search for news articles and filter by categories.
- 📌 **Bookmark & Read Later** – Save articles to read later, even offline.
- 📶 **Offline Mode** – Cache articles for offline reading.
- 🔔 **Breaking News Notifications** – Get real-time news alerts via push notifications.
- 🤖 **AI-Powered Summarization** – Use ML models to generate short article summaries.
- 🌎 **Multi-Language Support** – Provide news in multiple languages.
---
## 📸 Screenshots
---
## 🏗️ Installation Guide & Updating the App
Follow these steps to install and use the News App directly from the Releases section:
📥 **Step 1: Download the APK**
- Navigate to the **[Releases Section](https://github.com/Akarshjha03/HeadlineHub/releases/tag/v.1.0.0)** of this repository.
- Look for the latest release, usually at the top of the list and labeled with the latest version (e.g., v1.0.0).
- Under the "Assets" section of the release, click on the file with the **.apk** extension to download it to your device.
📱 **Step 2: Install the APK on Your Device**
- Open the downloaded **.apk** file on your Android device.
- You may need to enable "Install from Unknown Sources" in your device settings:
- Go to **Settings > Security > Unknown Sources** and toggle it on.
- Follow the on-screen instructions to complete the installation.
✅ **Step 3: Launch the App**
- Once the installation is complete, you can find the app in your app drawer.
- Open the app and start exploring the latest news! 📰🎉
---
🔄 **Updating the App**
- Whenever a new version is released:
- Visit the **[Releases Section](https://github.com/Akarshjha03/HeadlineHub/releases/tag/v.1.0.0)**.
- Download the latest **.apk** file and install it over the previous version. Your data will remain intact.
---
## 🤝 Contributing
Contributions are welcome! Feel free to open issues or submit pull requests to improve this project.
---
## 📜 License
This project is licensed under the **MIT License**.
---
## 📬 Contact
For any queries, reach out to me on:
- **GitHub**: [Akarshjha03](https://github.com/Akarshjha03)
- **LinkedIn**: [akarshjha03](https://linkedin.com/in/akarshjha03)
---
> _"Stay informed, stay ahead – because knowledge is power!"_
## 🚧 **This project is under active development. Stay tuned for more updates!** 🛠️