Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nitbravoa92/covid19-metrics-webapp
Covid19 Global Cases Stats is an application built with ReactJS and Redux to manage the global state of the application, the Disease.sh API is used to query and show users the covid19 disease-related statistics by continents and countries.
https://github.com/nitbravoa92/covid19-metrics-webapp
api-rest axios-react covid-19 react-router reactjs redux-thunk redux-toolkit
Last synced: about 6 hours ago
JSON representation
Covid19 Global Cases Stats is an application built with ReactJS and Redux to manage the global state of the application, the Disease.sh API is used to query and show users the covid19 disease-related statistics by continents and countries.
- Host: GitHub
- URL: https://github.com/nitbravoa92/covid19-metrics-webapp
- Owner: NitBravoA92
- License: mit
- Created: 2023-07-31T18:32:49.000Z (over 1 year ago)
- Default Branch: dev
- Last Pushed: 2023-08-04T23:03:04.000Z (over 1 year ago)
- Last Synced: 2024-11-20T19:56:59.128Z (about 2 months ago)
- Topics: api-rest, axios-react, covid-19, react-router, reactjs, redux-thunk, redux-toolkit
- Language: JavaScript
- Homepage: https://covid19-global-stats.onrender.com/
- Size: 945 KB
- Stars: 14
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Covid19 Global Cases Stats
# 📗 Table of Contents
- [📗 Table of Contents](#-table-of-contents)
- [Covid19 Global Cases Stats](#covid19-global-cases-stats)
- [🛠 Built With ](#-built-with-)
- [Tech Stack ](#tech-stack-)
- [Key Features ](#key-features-)
- [🚀 Live Demo ](#-live-demo-)
- [🔭 Walk through video ](#-walk-through-video-)
- [💻 Getting Started ](#-getting-started-)
- [Setup](#setup)
- [Prerequisites](#prerequisites)
- [Install](#install)
- [Usage](#usage)
- [Build](#build)
- [👥 Authors ](#-authors-)
- [🔭 Future Features ](#-future-features-)
- [🤝 Contributing ](#-contributing-)
- [⭐️ Show your support ](#️-show-your-support-)
- [🙏 Acknowledgments ](#-acknowledgments-)
- [📝 License ](#-license-)
**Covid19 Global Cases Stats** is an application built with ReactJS and Redux to manage the global state of the application, the Disease.sh API is used to query and show users the covid19 disease-related statistics by continents and countries
Client
- **Using the ReactJS library**
- **Using the ReactJS Router library**
- **Using JSX syntax**
- **Using semantic HTML**
- **SPA Approach**
- **Responsive Design**
- **Using Redux Toolkit for a global state management**
To see the application working live, you can click on the following link that contains the demo version:
- [Covid19 Global Cases Stats - Live Demo](https://covid19-global-stats.onrender.com/)
Video presentation of the Project
To get a local copy up and running, follow these steps.
### Setup
Clone this repository to your desired folder:
```sh
cd my-folder-name
git clone [email protected]:NitBravoA92/covid19-metrics-webapp.git
```
### Prerequisites
In order to install, modify and run this project, it is necessary to have the following applications installed:
- **Git:** to manage the project versions of source code. [You can Download Git here](https://git-scm.com/)
- **Nodejs and NPM:** to install and manage the project dependencies. [Nodejs and NPM installation guide](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
- **A code editor** like Visual Studio Code (Recommended) or any other of your preference. It is necessary to open the project and add or modify the source code. [You can Download Visual Studio Code here](https://code.visualstudio.com/)
It is also important to have at least basic knowledge about ReactJS, JSX, HTML, CSS and Javascript languages so you will be able to understand and work with the code of the project.
- [Learn the basics of HTML](https://developer.mozilla.org/en-US/docs/Web/HTML)
- [Learn the basics of CSS](https://developer.mozilla.org/en-US/docs/Web/CSS)
- [JavaScript basics](https://developer.mozilla.org/en-US/docs/Learn/Getting_started_with_the_web/JavaScript_basics)
- [Javascript Arrays](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Array)
- [Javascript Objects](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)
- [JavaScript modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules)
- [ReactJS](https://react.dev/learn)
- [JSX](https://react.dev/learn/writing-markup-with-jsx)
- [Create React App](https://github.com/facebook/create-react-app)
### Install
Install this project by running the next command into your project folder:
```sh
npm install
```
All the packages and libraries necessary for the project to work will be installed in a folder called /node_module. After this installation, the project will be ready to use.
### Usage
In the project directory, you can run:
- `npm start`
Runs the app in the development mode.\
Open [http://localhost:3000](http://localhost:3000) to view it in your browser.
The page will reload when you make changes.
You may also see any CSS and JS linters errors in the console running the following commands:
CSS Linter
```sh
npx stylelint "**/*.{css,scss}"
```
Javascript Linter
```sh
npx eslint "**/*.{js,jsx}"
```
### Build
- `npm run build`
Builds the app for production to the `build` folder.\
It correctly bundles React in production mode and optimizes the build for the best performance.
The build is minified and the filenames include the hashes.\
Your app is ready to be deployed!
See the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.
**Note**: Please only modify the components files and the CSS files. Do not modify configurations files of the project.
👤 **Nitcelis Bravo**
- GitHub: [Nitcelis Bravo](https://github.com/NitBravoA92)
- Twitter: [@softwareDevOne](https://twitter.com/softwareDevOne)
- LinkedIn: [Nitcelis Bravo Alcala](https://www.linkedin.com/in/nitcelis-bravo-alcala-b65340158)
- [x] **Create Home view**
- [x] **Create Countries Details view**
- [x] **Create Country Stats view**
- [x] **Use Redux to manage the states of continents and countries**
- [x] **Fetch data using the disease.sh API**
- [x] **Add CSS styles to the UI following the mobile first approach**
- [x] **Deploy the final version of the project and share Link Demo in the documentation**
- [x] **Create Unit tests using Jest and React testing library**
Contributions, issues, suggestions and feature requests are welcome!
Feel free to check the [issues page](../../issues/).
To do Contributions, please fork this repository, create a new branch and then create a Pull Request from your branch. You can find detailed description of this process in: [A Step by Step Guide to Making Your First GitHub Contribution by Brandon Morelli](https://codeburst.io/a-step-by-step-guide-to-making-your-first-github-contribution-5302260a2940)
If you liked this project, give me a "Star" (clicking the star button at the beginning of this page), share this repo with your developer community or make your contributions.
The UI design of this webapp is not mine. This design was created and belongs to Nelson Sakwa. (Here)[https://www.behance.net/gallery/31579789/Ballhead-App-(Free-PSDs)] you can find more information about the original design of this webapp and you can also see Nelson Sakwa's profile (here)[https://www.behance.net/sakwadesignstudio] to know more details about his wonderful work.
I would also like to thank my Microverse teammates for their support. They have supported me a lot in carrying out this project, giving me suggestions, good advice and solving my code doubts.
This project is [MIT](./LICENSE) licensed.
The UI design of the webpage is not mine. It is under (Creative Commons License)[https://creativecommons.org/licenses/by/3.0/] licensed.