mar19a / NewsApp

News App using NewsApi.org (Kotlin)

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

NewsApp

Screenshot 2024-02-28 at 1 33 51 AM

Overview

NewsApp brings the latest and most relevant news directly to your Android device. Powered by newsapi.org, this application ensures you're always up to date with the world's events. Experience a broad spectrum of news articles that you can read, save, and share at your convenience.

Features

  • News Feed: Explore headline news and discover articles from various categories directly from the home screen.
Screenshot 2024-02-28 at 1 34 46 AM
  • Search: Dive deeper and search for news articles that interest you.
Screenshot 2024-02-28 at 1 36 21 AM
  • Saved Articles: Keep your favorite news pieces saved for later reading.
Screenshot 2024-02-28 at 1 37 48 AM
  • Settings: Customize your news feed by changing your preferred news location settings.
Screenshot 2024-02-28 at 1 38 00 AM

Technical Highlights

  • API Integration: Utilizes Retrofit for efficient network operations with newsapi.org.
  • Dependency Management: Implements manual Dependency Injection for better code maintainability.
  • Pagination: Incorporates Paging3 Library for a seamless scrolling experience.
  • Data Management: Utilizes converters and Room Database for local data storage.
  • Reading Experience: Enhances user engagement with an integrated WebView for article reading.
Screenshot 2024-02-28 at 1 37 37 AM

Getting Started

To get a local copy up and running, follow these simple steps:

  1. Clone the repository: https://github.com/mar19a/NewsApp.git
    1. Open the project in Android Studio.
  2. Obtain an API key from newsapi.org and insert it into the designated place in your code.
  3. Build the project and run it on an Android device or emulator.

Usage

After launching the app, you will be greeted with the latest news on the 'News' tab. You can switch between different news categories to tailor the feed to your interests. Use the 'Search' feature to find specific news articles. Articles you wish to read later can be saved in the 'Saved' section. Personalize your news experience by adjusting the settings in the 'Settings' tab.

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

  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

License

Distributed under the MIT License. See LICENSE for more information.

Acknowledgments

  • Utilizes news data provided by newsapi.org.
  • Android Studio for the comprehensive development environment.
  • Retrofit, Paging3, and Room for making the app's backbone strong and functional.

About

News App using NewsApi.org (Kotlin)


Languages

Language:Kotlin 100.0%