Skip to content

News App written in Kotlin using Android Studio

Notifications You must be signed in to change notification settings

IvanSan2/Orator

Repository files navigation

Project logo

Project logo Orator

GitHub Repo stars GitHub last commit (by committer) GitHub forks GitHub pull requests GitHub watchers

📑 Content

📰 Description

Orator is a simple News App built with Kotlin Jetpack Compose. In this app, there is a Home, Search, Favorites and Settings pages. Home page display animated carousel with 10 latest news and lists distributed by categories with news from newsdata.io. Also app provides you to chose one of the following languages: English, Russian, Hebrew, Arabic or by default all languages includig those listed. You can use the search page page for searching news by keywords. Additionally you can save news in favorites and they are stored in local room database as well as all previously loaded news from network, which means that app is working without connection to internet too. This app has design that adjusts to phone colors and themes and has gestures effects.

👀 Screenshots

Dark theme Light Theme Dark theme Light Theme

⛓️ Dependencies

  • NavCompose
  • Hilt
  • Lifecycle
  • Coroutines
  • Room database
  • Retrofit
  • Logger for retrofit
  • Material3
  • AsyncImage
  • Accompanist pager
  • Material extra icons
  • Retrofitretry - avoid error 429

🏁 Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

To run this app as well and see all features, you need to register at NewsData.io and get the ApiKey.

Installing

  1. Clone the project to your local machine.
  2. Open the project with Android Studio.
  3. Run the project with emulator or build the APK ( Build > Build Bundle(s)/APK(s) > Build APK(s) )
  4. At settings screen (first screen that will load), enter your ApiKey from NewsData.io

🎲 Usage

Add Api key in setings screen (requared), chose your language (optional) and enjoy 😉

⛏️ Built With

🗞️ API Credit

✍️ Authors