News Application

News Application is a modern Android application that delivers top headlines from various countries using the News API. The application is written in Kotlin and follows Clean Architecture principles, showcasing a range of best practices and modern Android development tools.

Table of Contents

• Features
• Screenshots
• Technologies Used
• Getting Started
• Usage

Features

• Fetch and display the top headlines from various countries.
• Smooth and responsive UI with Jetpack Compose.
• Navigation using Navigation Compose.
• Dependency Injection with Dagger Hilt.
• Network requests with Retrofit and OkHttp.
• Image loading with Coil.
• Coroutines for asynchronous operations.
• State management with StateHolder.
• Flow for reactive programming.

Screenshots

Technologies Used

• Kotlin
• Jetpack Compose
• Navigation Compose
• Dagger Hilt
• Clean Architecture
• Retrofit
• OkHttp
• Kotlin Coroutines
• Coil
• Kotlin Flow

Getting Started

1. Clone the repository:

   git clone https://github.com/MilindAmrutkar/ComposeNewsApplication.git

2. Obtain your API key from News API:

   • Go to News API and register for an account if you don't have one.
   • Once registered and logged in, navigate to your account dashboard or visit this link.
   • Under the API Keys section, you can find your API key or generate a new one if needed.

3. Open the project in Android Studio.

4. Locate the ApiService class and replace the placeholder API_KEY in the endpoint URL with your actual API key. Ensure that you are passing the appropriate country code as a parameter in the API request.

5. Run the project on an emulator or a physical device.

Usage

Navigate through the app to read the top headlines. Click on the news headline to read the full article.