An open API service indexing awesome lists of open source software.

https://github.com/robyrawat/newshub

Modern Android news app with Material 3 design, pull-to-refresh, multi-language support, and offline reading Set as Public
https://github.com/robyrawat/newshub

android android-app bookmarks clean-architecture compose compose-ui dark-mode dependency-injection hilt jetpack-compose kotlin material-design mobile-app multi-language mvvm news-app open-source pull-to-refresh retrofit room-database

Last synced: about 1 month ago
JSON representation

Modern Android news app with Material 3 design, pull-to-refresh, multi-language support, and offline reading Set as Public

Awesome Lists containing this project

README

          

# ๐Ÿ“ฐ NewsHub - Modern Android News App


NewsHub Logo

**A beautiful, feature-rich news application built with Jetpack Compose**

[![Android](https://img.shields.io/badge/Platform-Android-green.svg)](https://android.com)
[![Kotlin](https://img.shields.io/badge/Language-Kotlin-blue.svg)](https://kotlinlang.org)
[![Jetpack Compose](https://img.shields.io/badge/UI-Jetpack%20Compose-orange.svg)](https://developer.android.com/jetpack/compose)
[![Material3](https://img.shields.io/badge/Design-Material%203-purple.svg)](https://m3.material.io)
[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)


๐Ÿ“ง **Developer:** [Ravi Rawat](mailto:RobyRawat2008@gmail.com) | ๐Ÿ’ผ **LinkedIn:** [Connect with me](https://www.linkedin.com/in/ravi-rawat-828839190/) | ๐Ÿ™ **GitHub:** [@robyrawat](https://github.com/robyrawat)

## โœจ Features

### ๐Ÿ”ฅ **Core Functionality**
- **๐Ÿ“ฑ Modern Material 3 Design** - Beautiful, adaptive UI that follows Google's latest design guidelines
- **๐ŸŒ Multi-language Support** - Read news in 10+ languages (English, Hindi, Arabic, Chinese, etc.)
- **๐Ÿ”„ Pull-to-Refresh** - Intuitive gesture-based content refreshing on all screens
- **โšก Real-time News** - Latest news from 1000+ sources worldwide via NewsData.io API
- **๐Ÿท๏ธ Category-based Browsing** - Technology, Sports, Business, Health, Entertainment, and more
- **๐Ÿ” Advanced Search** - Find specific articles with intelligent search functionality
- **๐Ÿ”ฅ Trending Section** - Discover what's hot and trending globally

### ๐Ÿ’พ **Smart Features**
- **๐Ÿ“š Bookmark System** - Save articles for offline reading with smart organization
- **๐Ÿ—‚๏ธ Reading History** - Track your reading patterns and quickly revisit articles
- **๐Ÿ’พ Offline Reading** - Read cached articles even without internet connection
- **๐Ÿ”„ Smart Caching** - Efficient storage of up to 200 articles for offline access
- **๐Ÿ“Š Multiple View Modes** - List, Grid, Image Overlay, and Card Stack layouts
- **๐ŸŽจ Dynamic Theming** - Adaptive colors and themes

### ๐Ÿ›ก๏ธ **Reliability & Performance**
- **โšก Fast Loading** - Optimized performance with lazy loading and caching
- **๐Ÿ›ก๏ธ Error Resilience** - Graceful handling of network issues and API limits
- **๐Ÿ”„ Auto-retry Logic** - Automatic retry mechanisms for failed requests
- **๐Ÿ’จ Smooth Animations** - Fluid transitions and micro-interactions
- **๐Ÿ“ณ Haptic Feedback** - Enhanced user experience with tactile responses

## ๐Ÿ—๏ธ **Technical Architecture**

### **Built With Modern Android Stack**
- **๐Ÿ›๏ธ MVVM Architecture** - Clean, maintainable, and testable code structure
- **๐ŸŽฏ Jetpack Compose** - Declarative UI toolkit for native Android
- **๐Ÿ’‰ Hilt Dependency Injection** - Compile-time correct dependency injection
- **๐Ÿ”„ Coroutines & Flow** - Asynchronous programming and reactive streams
- **๐Ÿ—ƒ๏ธ Room Database** - Local data persistence and caching
- **๐ŸŒ Retrofit** - Type-safe HTTP client for API communication
- **๐Ÿ–ผ๏ธ Coil** - Fast and lightweight image loading library
- **๐Ÿ“ฑ Navigation Component** - Single-activity architecture with fragment navigation

### **Key Technologies**
```
โ€ข Kotlin 100%
โ€ข Jetpack Compose UI
โ€ข Material Design 3
โ€ข Hilt for DI
โ€ข Coroutines + Flow
โ€ข Retrofit + OkHttp
โ€ข Room Database
โ€ข DataStore Preferences
โ€ข Coil Image Loading
โ€ข Navigation Component
```

## ๐Ÿš€ **Getting Started**

### **Prerequisites**
- Android Studio Hedgehog | 2023.1.1 or newer
- JDK 17 or higher
- Android SDK API 24+ (Android 7.0)
- Internet connection for news data

### **Installation**

1. **Clone the repository**
```bash
git clone https://github.com/robyrawat/NewsHub.git
```

2. **Get your NewsData.io API Key**
- Visit [NewsData.io](https://newsdata.io) and create a free account

3. **Build and Run**
```bash
./gradlew assembleDebug
```
Or open in Android Studio and click โ–ถ๏ธ Run

## ๐Ÿ“ธ **Screenshots**
Screenshot_20250924_175720

Screenshot_20250924_175742

Screenshot_20250924_175756
Screenshot_20250924_175804
Screenshot_20250924_175811Screenshot_20250924_175818
Screenshot_20250924_175837
Screenshot_20250924_175908

## ๐ŸŽฏ **Use Cases**

Perfect for:
- **๐Ÿ“ฐ News Enthusiasts** - Stay updated with latest global and local news
- **๐ŸŽ“ Students & Researchers** - Access diverse news sources for academic projects
- **๐Ÿ’ผ Professionals** - Keep track of industry-specific news and trends
- **๐ŸŒ Travelers** - Get news in multiple languages and regions
- **๐Ÿ“ฑ Android Developers** - Learn modern Android development practices

## ๐Ÿค **Contributing**

We welcome contributions! Here's how you can help:

1. **๐Ÿด Fork the Project**
2. **๐ŸŒฟ Create your Feature Branch** (`git checkout -b feature/AmazingFeature`)
3. **๐Ÿ’ป Commit your Changes** (`git commit -m 'Add some AmazingFeature'`)
4. **๐Ÿ“ค Push to the Branch** (`git push origin feature/AmazingFeature`)
5. **๐Ÿ”€ Open a Pull Request**

### **What We're Looking For**
- ๐Ÿ› Bug fixes and improvements
- โœจ New features and enhancements
- ๐ŸŒ Language translations
- ๐Ÿ“š Documentation improvements
- ๐Ÿงช Unit and integration tests
- ๐ŸŽจ UI/UX enhancements

## ๐Ÿ™ **Acknowledgments**

- **NewsData.io** - For providing comprehensive news API
- **Material Design Team** - For the beautiful design system
- **Jetpack Compose Team** - For the amazing UI toolkit
- **Android Developer Community** - For continuous inspiration and support

## ๐Ÿ”— **Links & Contact**

- **๐Ÿ“ฑ Download APK** - [Latest Release](https://github.com/robyrawat/NewsHub/releases)
- **๐Ÿ› Report Issues** - [GitHub Issues](https://github.com/robyrawat/NewsHub/issues)
- **๐Ÿ’ก Feature Requests** - [Discussions](https://github.com/robyrawat/NewsHub/discussions)

### ๐Ÿ“ง **Get in Touch**
- **Email:** [RobyRawat2008@gmail.com](mailto:RobyRawat2008@gmail.com)
- **LinkedIn:** [Connect with Ravi](https://www.linkedin.com/in/ravi-rawat-828839190/)
- **GitHub:** [@robyrawat](https://github.com/robyrawat)

---



**โญ Star this repository if you found it helpful!**

### ๐Ÿ”Ž Keywords
android, kotlin, jetpack-compose, material-design, mvvm, hilt, room-database, retrofit, news-app, mobile-app, rss-reader, offline-support, bookmarks, multi-language, dark-mode, material-you, clean-architecture, dependency-injection, news-aggregator, open-source, compose-ui, android-app

Made with โค๏ธ for the Android community