<p> <img src="./asset/MMILft.Hacktober.jpeg" > </p>
<h1 align="center">Welcome to News Recital 👋</h1>

[![GitHub stars](https://img.shields.io/github/stars/MMIL/NewsRecital?style=social)](https://github.com/login?return_to=%2FMMIL%NewsRecital) 
 ![GitHub forks](https://img.shields.io/github/forks/MMIL/NewsRecital?style=social) 
 ![GitHub pull requests](https://img.shields.io/github/issues-pr/MMIL/NewsRecital)
 ![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed/MMIL/NewsRecital) 
 ![GitHub last commit](https://img.shields.io/github/last-commit/MMIL/NewsRecital) 
 ![GitHub issues](https://img.shields.io/github/issues-raw/MMIL/NewsRecital)
 [![Open Source Love](https://badges.frapsoft.com/os/v2/open-source.svg?v=103)](https://github.com/MMIL/NewsRecital) 

An app that gives you the latest news from the top sources . It is built using Flutter framework which helps ease the process of building beautiful designs.News categories ranges from bussiness to sports. You can choose news category displayed on home page. App is providing a smooth and amazing design with gestures effect and smooth experience with android and iOS both platform.

## Features
* Explore news based on categories
* Dark mode support.
* In app Web view
* Voice Assistance via tts
* Seamless user experience
* Sharing articles
* Go to detail news website.

## Dependencies
<ul>
 <li><a href="https://flutter.io/"><img src ="https://flutter.dev/assets/flutter-lockup-1caf6476beed76adec3c477586da54de6b552b2f42108ec5bc68dc63bae2df75.png" width="100" height="25" ></a></li>
 <li><a href="https://newsapi.org/"><img src ="https://s3.amazonaws.com/appforest_uf/f1479799611909x580051703844219400/news_api_logo.PNG" width="100" height="50" ></a></li>
  <li><a href="https://pub.dev/packages/http"><img src ="https://pub.dev/static/img/dart-logo-400x400.png" width="50" height="50" ></a></li>
 <li><a href="https://pub.dev/packages/flutter_inappwebview"><img src ="https://miro.medium.com/max/400/1*_6Dh7jYd1Rh4GjFymFUA8w.png" width="50" height="50" ></a></li>
 <li><a href="https://pub.dev/packages/flutter_tts"><img src ="https://www.easytechtrick.org/wp-content/uploads/2017/11/Text-To-Speech-Apps.jpg" width="70" height="50" ></a></li>
 <li> <h4> <a href="https://pub.dev/packages/url_launcher"  style =" text-decoration: none;">URL LAUNCHER</a></h4></li>
 <li><h4><a href="https://pub.dev/packages/dynamic_theme" style =" text-decoration: none;">Dynamic Theme</a></h4></li>
 
 
 <li><a href="https://pub.dev/packages/google_fonts"><img src ="https://www.gstatic.com/images/icons/material/apps/fonts/1x/opengraph_color_blue_1200dp.png" width="100" height="50" ></a></li>
 </ul>

## Screenshot
<img src="./Screenshot/NewsRecital.jpg" >

## Download App 
<a href="https://drive.google.com/file/d/1g9cswP8B5Ru_lIE6q32YEjrp5VFnguJq/view?usp=sharing"><img src="https://playerzon.com/asset/download.png" width="200"></img></a>

# Contribution Guidelines

## 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


Please feel free to file issues at [NewsRecital issues](https://github.com/MMIL/NewsRecital/issues). Flutter issues can be filed at [Flutter issues](https://github.com/flutter/flutter/issues).

You can also contribute changes. Setting up:
1. Fork `https://github.com/MMIL/NewsRecital.git` into your own GitHub account
2. `git clone https://github.com/<your_name_here>/NewsRecital.git`
3. `cd NewsRecital.git`
4. `git remote add upstream https://github.com/<your_name_here>/NewsRecital.git`

Submitting changes:
1. `git fetch upstream`
2. `git checkout upstream/master -b name_of_your_branch`
3. Make changes
4. `git commit -a -m "<your informative commit message>"`
5. `git push origin name_of_your_branch`

To send a pull request:
1. `git pull-request` (if you are using [Hub](https://hub.github.com/)) or go to [NewsRecital](https://github.com/MMIL/NewsRecital) and click the "Compare & pull request" button
2. Tag the relevant people and GitHub issue (if any)

## News API Credit
https://newsapi.org/

