Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/kidd254/math-magicians-react-app

⚛️ Math Magicians is a website for all fans of mathematics. This Single Page App (SPA) that allows users make simple calculations and read a random math-related quote.
https://github.com/kidd254/math-magicians-react-app

api css html javascript react-hooks reactjs tailwind-css

Last synced: 27 days ago
JSON representation

⚛️ Math Magicians is a website for all fans of mathematics. This Single Page App (SPA) that allows users make simple calculations and read a random math-related quote.

Awesome Lists containing this project

README

        

# 📗 Table of Contents

- [📖 About the Project](#about-project)
- [🛠 Built With](#built-with)
- [Tech Stack](#tech-stack)
- [Key Features](#key-features)
- [🚀 Live Demo](#live-demo)
- [💻 Getting Started](#getting-started)
- [Setup](#setup)
- [Prerequisites](#prerequisites)
- [Install](#install)
- [Usage](#usage)
- [Run tests](#run-tests)
- [👥 Authors](#authors)
- [🔭 Future Features](#future-features)
- [🤝 Contributing](#contributing)
- [⭐️ Show your support](#support)
- [🙏 Acknowledgements](#acknowledgements)
- [📝 License](#license)

# 📖 Math Magicians

> This is a math magician's app built with HTML, CSS, and REACT in this app you can make some calculations math like addition and division..etc, also I used the external API to fetch some quotes for the app using the use effect hook.

## 🛠 Built With

### Tech Stack

Client

### Key Features

- [x] Set up the project using (CRA) create-react-app👍.
- [x] Remove the boilerplate from the project after setting up💯.
- [x] Use the basic CSS style for styling the components.

(back to top)

## 🚀 Live Demo

- [a link to the online version](https://lawrences-math-magicians-react-app-iy4q.onrender.com/)

- [a link to a presentation about this project]()

(back to top)

## 💻 Getting Started

To get a local copy up and running, follow these steps.

### Prerequisites

In order to run this project you need:

### Setup

Clone this repository to your desired folder:

```sh
cd my-folder
git clone [email protected]:Kidd254/Math-Magicians-React-App.git
```

### Install

Install this project with:
```sh
cd Math-Magicians-React-App
npm install
```

### Usage

To run the project, execute the following command:

```sh
npm start
```

### Run tests

To run tests for the linter, run the following command:

```sh
npx hint .
npx eslint . --fix
```

(back to top)

## 👥 Authors

👤 **Lawrence Muema Kioko**
- GitHub: [@githubhandle](https://github.com/Kidd254)
- Twitter: [@twitterhandle](https://twitter.com/lawrenc98789206)
- LinkedIn: [LinkedIn](https://www.linkedin.com/in/lawrence-muema-kioko-972035240/)

(back to top)

## 🔭 Future Features

- [x] I will test this app using the library from React or maybe use Jest to test it👌💯.
- [x] Add the react-router dom for the project to navigate from the pages using the navigation
- [x] Add the Quotes component to fetch the quotes from the API 🚀

(back to top)

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](https://github.com/Kidd254/Math-Magicians-React-App/issues).

(back to top)

## ⭐️ Show your support

- If you like this project you can give me a star 😊 just to prove my app that it is useful for everyone and the users can use it to calculate anything 💯.

(back to top)

## 🙏 Acknowledgments

- I would like to thank Microverse for this opportunity.

(back to top)

## ❓ FAQ

- What is this for?

This is a React.js project created by Microverse to allow students learn and practice React.js.

- Can I copy this project?

Your welcome, copy this project and let us know if you need something.

## 📝 License

This project is [MIT](https://github.com/Kidd254/Math-Magicians-React-App/blob/set-up/LICENSE) licensed.

(back to top)