Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vijethph/covidstatsapp

A Flutter app that gives the latest Covid-19 statistics
https://github.com/vijethph/covidstatsapp

android api-client covid-19 dart flutter http-requests url-launcher

Last synced: 14 days ago
JSON representation

A Flutter app that gives the latest Covid-19 statistics

Awesome Lists containing this project

README

        

[![Status](https://img.shields.io/badge/status-active-success.svg?style=flat-square&logo=flutter)]()
[![GitHub issues](https://img.shields.io/github/issues/vijethph/CovidStatsApp?style=flat-square)](https://github.com/vijethph/CovidStatsApp/issues)
[![Contributors](https://img.shields.io/github/contributors/vijethph/CovidStatsApp?style=flat-square)](https://github.com/vijethph/CovidStatsApp/graphs/contributors)
[![GitHub forks](https://img.shields.io/github/forks/vijethph/CovidStatsApp?color=blue&style=flat-square)](https://github.com/vijethph/CovidStatsApp/network)
[![GitHub stars](https://img.shields.io/github/stars/vijethph/CovidStatsApp?color=yellow&style=flat-square)](https://github.com/vijethph/CovidStatsApp/stargazers)
[![GitHub license](https://img.shields.io/github/license/vijethph/CovidStatsApp?style=flat-square)](https://github.com/vijethph/CovidStatsApp/blob/master/LICENSE)
[![made-with-flutter](https://img.shields.io/badge/Made%20with-flutter-blue.svg?style=for-the-badge&labelColor=darkviolet)](https://www.android.com)
[![forthebadge](https://forthebadge.com/images/badges/built-for-android.svg)](https://forthebadge.com)





Logo

Covid-19 Stats App


A Flutter app that gives the updated report of Covid-19 related statistics in a neat and consistent manner.




Report Bug
ยท
Request Feature

## Table of Contents

* [About the Project](#about-the-project)
* [Built With](#built-with)
* [Getting Started](#getting-started)
* [Prerequisites](#prerequisites)
* [Installation](#installation)
* [Usage](#usage)
* [Contributing](#contributing)
* [License](#license)
* [Contact](#contact)
* [Acknowledgements](#acknowledgements)

## About The Project

Project working second screenshot

This is a Flutter app that uses [Flutter UI Kit](https:/flutter.dev) and [Novel Covid API](https://corona.lmao.ninja) to retrieve the latest Covid-19 related statistics, and display them in a consistent manner. It displays various information related to the disease, such as worldwide confirmed count, most affected countries, and state-wise confirmed cases with respect to the country India. The app is also available in Kannada language.

### Built With
This project is entirely built with the following components and languages:
* [Flutter](https://flutter.dev)
* [Novel Covid API](https://corona.lmao.ninja)
* [http Dart Package](https://pub.dev/packages/http)

## Getting Started

The Android app, and its Kannada version are available in the [Releases](https://github.com/vijethph/CovidStatsApp/releases) section, which can be directly downloaded and installed. To get a local copy of the program up and running, hence manually building the project, follow these simple steps.

### Prerequisites

Java Runtime Environment(JRE)>=8, Android SDK API level 28, and Flutter SDK should be installed. After installation, check Java version, and Flutter configuration using

```sh
java --version
flutter doctor
```

### Installation

1. Clone the repo
```git
git clone https://github.com/vijethph/CovidStatsApp.git
```
2. Open the downloaded folder
```sh
cd CovidStatsApp
```
3. Make sure Flutter executable is added to environment variables. Then import the required dependencies using
```sh
flutter pub get
```
4. Connect your Android device to your desktop. Make sure it is properly connected by using
```sh
flutter devices
```
Finally run the program using
```sh
flutter run
```

## Usage

Once the app starts, you can check the Worldwide statistics related to Covid-19, most affected countries. The 'Regional' button opens the state-wise information about India. There is also a 'Frequently Asked Questions' page based on guidelines from [WHO](https://www.who.int).

## Contributing [![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat-square)](https://github.com/vijethph/CovidStatsApp/pulls)

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## License

Distributed under the GNU GPL License.

## Contact

Vijeth P H - [@vijethph](https://github.com/vijethph)

Project Link: [https://github.com/vijethph/CovidStatsApp](https://github.com/vijethph/CovidStatsApp)

## Thank You!
[![forthebadge](https://forthebadge.com/images/badges/built-with-love.svg)](https://forthebadge.com)

If you like this project, please โญ this repo and share it with others ๐Ÿ‘

## Acknowledgements
* [Flutter Docs](https://docs.oracle.com/javafx)
* [Novel Covid API](https://shields.io)
* [Choose an Open Source License](https://choosealicense.com)
* [Saheb Singh](https://github.com/singh-saheb)