# News-App

**Repository Path**: zzh123456/News-App

## Basic Information

- **Project Name**: News-App
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-03-11
- **Last Updated**: 2024-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# News-App 📰

### Overview :
Kotlin-based Android news app helps users stay up-to-date on the latest headlines.

### Features :
* Display News in various categories 
* Dark mode
* Share news with friends
* Browse news
* Bookmark news to read later/ Delete news
* Listen news with provided Text-To-Speech service

 ### Screenshots : 
 
 <table align="center">
  <tr>
    <td><img src="https://github.com/Raj-m01/News-App/blob/master/screenshots/mainactivity.jpeg" alt="News home" style="width:200px;height:400px;"></td>
    <td><img src="https://github.com/Raj-m01/News-App/blob/master/screenshots/read%20news%20activity.jpeg" alt="Read News" style="width:200px;height:400px;"></td>
    <td><img src="https://github.com/Raj-m01/News-App/blob/master/screenshots/saved%20news%20activity.jpeg" alt="saved" style="width:200px;height:400px;"></td>
  </tr>
  
  <tr>
    <td><img src="https://github.com/Raj-m01/News-App/blob/master/screenshots/home.jpeg" alt="News home" style="width:200px;height:400px;"></td>
    <td><img src="https://github.com/Raj-m01/News-App/blob/master/screenshots/browse.jpeg" alt="read News" style="width:200px;height:400px;"></td>
    <td><img src="https://github.com/Raj-m01/News-App/blob/master/screenshots/saved.jpeg" alt="saved news" style="width:200px;height:400px;"></td>
  </tr>
   
</table><br><br>

### Tools and Tech stack used : 

 * Kotlin
 * XML
 * MVVM Architecture
 * Room database library
 * Android Studio
 * Third party libraries like [retrofit](https://square.github.io/retrofit/), [picasso](https://square.github.io/picasso/), [shimmer](https://github.com/facebook/shimmer-android).

### Getting Started :
Note: To run the app you have to add NewsAPI.org key. This API has limited access to daily request for News. 
 * Generate API key from <a href="https://newsapi.org/">News api</a>
 *  Paste the key in 'gradle.properties' *(Create the file if not exists)*
 
    API_KEY="<YOUR_API_KEY>"
 * Rebuild app
 

### Application link : <a href="https://drive.google.com/file/d/1u0A4mCkY98cfavE32c6GH_bVp0v9wujr/view?usp=sharing">**Click here to download apk**</a>

### Contributing

   - Contributions are always welcome!

   - See [CONTRIBUTING.md](https://github.com/Raj-m01/News-App/blob/master/CONTRIBUTING.md) for ways to get started.

  
### For hackoberfest:

- **Before creating any Pull Request, please register yourself at [Hacktoberfest's Official Website](https://hacktoberfest.digitalocean.com/)**
- **If a maintainer reports behavior that’s not in line with the project’s code of conduct, then you will be ineligible to participate.**
- **If a maintainer reports your pull request as spam, it will not be counted towards your participation in Hacktoberfest.**


### 📝 License 

Copyright (c) 2022 Raj Manjrekar

This project is [MIT](https://github.com/Raj-m01/News-App/blob/master/License) licensed.