newsplus

News+

News+ is an Android app designed to provide Business & Financial News with the ability to save articles to read later, create watchlists of stocks & much more.

This repository contains the source code for News+ developed using the Flutter framework. The app is designed to provide various features and functionalities to enhance user experience. Below, you will find information about how to download the app, its features, dependencies, license, and more.

Download

You can download the latest version of the app from the GitHub Releases page. Look for the most recent release and download the corresponding APK or installer file for your device.

Requirements

• Any Operating System (ie. MacOS X, Linux, Windows)
• Any IDE with Flutter SDK installed (ie. IntelliJ, Android Studio, VSCode, etc)
• A little knowledge of Dart and Flutter

Features

• Dive into a vast collection of news articles from around the globe.
• Enjoy a seamless reading experience with a clean and intuitive interface.
• Save your favorite articles to read later.
• Stay ahead of the curve by creating your watchlist.
• Create a personalized library of articles that matter to you.

Screenshots

Installation

To run the app locally and make modifications, follow these steps:

1. Ensure you have Flutter SDK installed on your machine. You can download it from the official Flutter website: https://flutter.dev.

2. Clone this repository to your local machine using the following command:
   

   git clone https://github.com/sarthakkimtani/newsplus.git

3. Navigate to the project directory:
   
   

   cd newsplus

4. Fetch the app's dependencies by running the following command:
   

   flutter pub get

5. Create a new JSON file named api_keys.json & add your API Keys using:
   

   {
     "NEWS_API": "<API_KEY>",
     "STOCK_API": "<API_KEY>"
   }

   API Keys for News API can be found at newsapi.org
   API Keys for Stock API can be found at RapidAPI

6. Connect your device or start an emulator.

7. Run the app using the following command:
   

   flutter run --dart-define-from-file=api_keys.json

Dependencies

Name	Usage
HTTP	HTTP Requests
Shimmer	Shimmer for Loading Screens
Provider	State Management
Localstore	JSON file-based storage package
URL Launcher	URL Launcher for opening Web links
Firebase Core	Firebase Backend
Firebase Authentication	Firebase Authentication
WebView	WebView Widget
Cached Image	Cache Network Images

Contributing

Contributions to this app are welcome! If you find any issues or have ideas for improvements, please open an issue or submit a pull request. Make sure to follow the repository's guidelines for contributing.

License

This app is distributed under the MIT License. Feel free to modify and use it as per your requirements.