📰 News App

Maintainer

Farhaan Shaikh

📖 Description

The News App is an Android application built with Java and XML that allows users to stay updated with the latest news across various categories. Users can browse news by category, search for news based on keywords, and save articles for later reading. The app fetches news data from the gnews.io API, offering a seamless and intuitive interface for keeping up with current events.

✨ Features

• 🌐 Category-Wise News: Fetch news based on categories like Entertainment, Sports, Politics, Technology, and more.
• 🔍 Search News: Search for news articles based on keywords.
• ⭐ Add to Favourites: Save your favorite news articles for easy access later.
• ⏳ Watch Later: Mark articles to read or watch later.
• 📜 View Full Articles: Click on any article to view full details with an option to open the original source.

🚀 Installation

1. Clone the repository:

   git clone https://github.com/FSfarhaan/News-App.git

2. Open the project in Android Studio:

   • Open Android Studio
   • Click on File -> Open
   • Select the cloned repository folder

3. Set up API Key:

   • Sign up on gnews.io and get your API key.
   • Add Your API key to your project in utils/Constants.java.

4. Build and Run the app:

   • Connect your Android device or start an emulator.
   • Click on the Run button in Android Studio.

🛠️ Usage

1. Browsing News by Category:

   • Open the app and choose a category from the top navigation (e.g., Entertainment, Sports, etc.).
   • Browse through the list of articles in your selected category.

2. Searching for News:

   • Use the search bar to enter keywords and fetch relevant articles.

3. Adding News to Favourites:

   • Tap the heart icon on any article to add it to your favourites section.

4. Watch Later:

   • Tap the save icon on any article to save it to your 'Watch Later' list.

5. View Full Article:

   • Click on any news item to read more details, or follow the link to the original article for the full content.

🧩 Code Overview

API Integration

• gnews.io API: The app uses the gnews.io API to fetch news based on categories and search terms.
• Retrofit: A type-safe HTTP client is used for making API calls.

📱 Screenshots

🤝 Contributing

Contributions are welcome! If you'd like to improve the app or add new features, feel free to create an issue or submit a pull request.

📬 Contact

If you have any questions or suggestions, feel free to contact me at farhaan8d@gmail.com.
Connect with me on LinkedIn.