Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/arpitaswal/global-news
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.
https://github.com/arpitaswal/global-news
dart flutter-app lazy-loading location-based rest-api shimmer-effect
Last synced: 6 days ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/arpitaswal/global-news
- Owner: ArpitAswal
- Created: 2024-08-09T14:49:04.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-11-04T05:54:08.000Z (12 days ago)
- Last Synced: 2024-11-04T06:28:04.234Z (12 days ago)
- Topics: dart, flutter-app, lazy-loading, location-based, rest-api, shimmer-effect
- Language: Dart
- Homepage:
- Size: 1.04 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## App Logo
Click on a logo to download the latest version of the app apk file:
## Project Title: Global News
Description: 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:
1. Clone the repository:
git clone https://github.com/ArpitAswal/Global-News.git
2. Navigate to the project directory:
cd Global-News
3. Install dependencies:
flutter pub get
4. 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.
5. 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.
## Future Enhancements
In future releases, Global News will include several new features to enhance customization and personalization:
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.
## Contributing
Contributions are always welcome!
Please follow these steps:
1. Fork the repository.
2. Create a new branch (git checkout -b feature-branch).
3. Make your changes and commit them (git commit -m 'Add new feature').
4. Push the changes to your fork (git push origin feature-branch).
5. Create a pull request.
## 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-
## Feedback
If you have any feedback, please reach out to me at [email protected]
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.