Jan Samachar News App

Description

Jan Samachar is a simple and modern Android news application built with Kotlin. It fetches the latest top headlines from the NewsAPI and displays them in a clean, user-friendly interface. This project demonstrates modern Android development practices, including a clean architecture, asynchronous data fetching, and secure API key management.

Features

• 📰 Top Headlines: Fetches and displays the top news headlines from the US.
• 🔄 Swipe to Refresh: Users can swipe down to refresh the news feed.
• ♾️ Infinite Scrolling: Automatically loads more articles as the user scrolls to the bottom.
• 🖼️ Detailed View: Click on any article to see its full details in a separate screen.
• ❤️ Interactive UI: Includes placeholder like/dislike, comment, and share functionality on each article.
• 📱 Responsive Layout: Adapts its layout for both phones (single column) and tablets (grid view).
• 🔒 Secure API Key: The NewsAPI key is stored securely and is not exposed in the version-controlled code.
• ⚠️ Error Handling: Shows user-friendly messages for network errors or when news fails to load.

Tech Stack & Key Libraries

• Language: Kotlin
• Architecture: MVVM (Model-View-ViewModel)
• Asynchronous: Kotlin Coroutines for managing background threads.
• Networking: Retrofit for making API calls.
• Database: Room for saving favorite articles locally.
• UI & Navigation:
  • Android Jetpack's Navigation Component
  • RecyclerView & CardView
  • ViewBinding
• Image Loading: Glide for efficient image loading and caching.

Setup Instructions

To build and run this project locally, follow these simple steps:

1. Clone the repository:

   git clone <your-repository-url>

2. Get a NewsAPI Key:

   • Go to newsapi.org and register to get your free API key.

3. Create local.properties file:

   • In the root directory of the project (the same folder where build.gradle.kts is), create a new file named local.properties.

4. Add your API Key:

   • Open the local.properties file and add your API key in the following format:

   NEWS_API_KEY="YOUR_NEWS_API_KEY_HERE"

   Replace YOUR_NEWS_API_KEY_HERE with the actual key you got from newsapi.org.

5. Build and Run:

   • Open the project in Android Studio.
   • Let Gradle sync all the dependencies.
   • Run the app on an emulator or a physical device.

Screenshots

(You can add screenshots of your application here to showcase the UI)

| Headlines Screen |

| Article Detail Screen |

| Favourite Section Screen | ( Dark Mode )