Global-News

App Logo

Click on a logo to download the latest version of the app apk file:

Project Title: Global News

Global News is a dynamic mobile application built using Flutter and Dart, designed to keep users informed with up-to-date global news articles. The app fetches news articles using an API and displays them based on the user's location and preferences. With a focus on user-friendly design and seamless experience, Global News ensures that users have easy access to the latest news from around the world. The app features a splash screen that transitions smoothly into the Home screen, where users are presented with top headlines and other news stories based on their country, automatically determined by the device location.

Features

Splash Screen

• A splash screen is displayed upon launching the app, enhancing the user interface experience.

Top Headlines

• Stay informed with top headlines from around the globe.

Country & Category Selection

• Filter news based on country or category, including technology, business, health, sports, and more.

Search Functionality

• Easily find articles by keywords.

Lazy Loading

• News articles load as you scroll, optimizing performance and speed.

Refresh Capability

• Quickly refresh content to view the latest updates.

Voice Text Feature

• For added accessibility, the NewsDetail screen includes a voice text feature.

Gemini AI Chatbox

• The app introduces the Gemini AI Chatbox, powered by the Gemini-1.5-flash model. Available on nearly every screen, this AI assistant allows users to ask questions and receive informative responses with up to 80-90% accuracy, though without creative interpretations or confidential information.

Smooth User Interface

• Designed for a seamless, user-friendly experience with a focus on readability and easy navigation.

Installation

To run this project locally:

• Clone the repository: git clone https://github.com/ArpitAswal/Global-News.git

• Navigate to the project directory: cd Global-News

• Install dependencies: flutter pub get

• Set up API Key: Obtain an API key from News API.

  Create a new file named lib/config.dart in the project directory.

  Add the following code, replacing 'YOUR_API_KEY' with your News API key:

  class Config { static const String apiKey = 'YOUR_API_KEY'; }

  Or directly used in API networking calls.

• Run the app: flutter run

Note

• Users must grant location permission for the app to function, as it uses, the device's location to fetch news data.

• Users may need to refresh the screen after allowing location access from the settings for the first time.

• The API may not provide, perfectly accurate data, as it does not support fetching articles solely by country. This is particularly relevant for top headlines. For more information about the API, visit News API: "https://newsapi.org/"

Tech Stack

• Flutter: The primary framework for building the mobile application.

• Dart: The programming language used with Flutter.

• News API: For, fetching global news articles.

• Gemini API: Gemini API for processing text-based queries and providing informative answers.

Challenges

Location Permissions:

• Ensuring user privacy while handling location-based news.

API Limitations:

• Managing API rate limits for a smooth, continuous experience.

Cache Mecahnism:

• Providing cache data during the network connection problem

Future Enhancements

Advanced Filtering

• Users will be able to filter the news list by date ranges, allowing them to view articles published within specific periods (e.g., X to Y date). Additional sorting options will include relevance, popularity, and publication date, giving users more control over how they view news stories.

User Account and Saved Articles

• The app will offer user account profiles where they can manage their information and preferences. Within their profile, users will have access to a Favorites Section to save or like articles they want to revisit. This feature will allow users to save articles directly from the NewsDetail screen, creating a personalized library of favourite content.

Sign-In and Sign-Out

• The addition of sign-in and sign-out options will support the Favorites Section, allowing users to maintain their saved articles across devices and sessions.

Usage Flow

• The user opens the Global News app and the splash screen is displayed.

• The user is taken to the home screen, where top headlines and other news articles are displayed based on the default country but before that it will display a shimmer effect until data is fetched.

• this image shows the different scenarios while displaying the data list

• The user can search for specific articles using the search feature.

• The user can select a different country to view news articles specific to that location.

• The user can navigate to the categories screen to view articles by category.

• The user can see more details about the article by clicking on the individual article and even in detail screen user can see more about an article from the browser by clicking on the site URL.

• Here is the Gemini AI chat box screen-

Contributing

Contributions are always welcome!

Fork the Repository:

• Go to the original repository on GitHub or GitLab.
• Click the "Fork" button. This creates a copy of the repository under your own account.

Create a New Branch:

• Clone your forked repository to your local machine: git clone <your_fork_url>
• Create a new branch for your feature: git checkout -b feature-branch
• Replace feature-branch with a descriptive name for your changes (e.g., fix-bug, add-feature).

Make Changes and Commit:

• Make the necessary changes to the code in your local feature-branch.
• Stage the changes: git add (or git add . to stage all changes)
• Commit the changes with a clear message: git commit -m "Add new feature"
• Use a descriptive and concise message that explains the changes.

Push Changes to Your Fork:

• Push your feature-branch to your remote repository: git push origin feature-branch

Create a Pull Request:

• Go back to the original repository on GitHub or GitLab.
• Click the "New Pull Request" button.
• Select your feature-branch as the source and the original repository's main or develop branch as the target.
• Provide a clear description of your changes and why they are needed.
• Submit the pull request.

Feedback

• If you have any feedback, please reach out to me at arpitaswal995@gmail.com
• If you face an issue, then open an issue in a GitHub repository.

Design Philosophy

Global News is designed to provide users with easy access to global news in a seamless and user-friendly manner. The app focuses on delivering a smooth user experience while ensuring that users can easily find and read news articles relevant to their interests and location.