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

https://github.com/libercosoft/maths-magicians

A Single Page Application that make simple math calculations and read a random math-related quote.
https://github.com/libercosoft/maths-magicians

Last synced: 2 months ago
JSON representation

A Single Page Application that make simple math calculations and read a random math-related quote.

Awesome Lists containing this project

README

          

# math-magicians

![microverse icon](https://img.shields.io/badge/Microverse-blueviolet)

> A Single Page App (SPA) that allows users to Make simple calculations and read a random math-related quote.

"Math magicians" is a Single Page App (SPA) that allows users to:

- Make simple calculations.
- Read a random math-related quote.

## Built With

- Major Languages: JavaScript.
- Libraries: React,
- Technologies used:

```bash
- create-react-app tool
- Git version control
- ESLint code linting
- StyleLint code linting
- Prettier code formatting
- Babel transpiling
- Webpack bundling
- netlify deployment
```

## Live Demo

[Live Demo](https://aesthetic-salmiakki-eb0e63.netlify.app/)

## Getting Started

To get a local copy up and running, follow the steps in Setup below.

### Prerequisites

Basic knowledge of HTML, CSS, JavaScript, and React.

### Setup

If you installed git you can clone the code to your machine, or download a ZIP of all the files directly.

[Download the ZIP from this location](https://github.com/LIBERCOSOFT/maths-magicians/archive/refs/heads/development.zip), or run the following [git](https://git-scm.com/downloads) command to clone the files to your machine:

```bash
git clone https://github.com/LIBERCOSOFT/maths-magicians.git - for HTTP
git clone git@github.com:LIBERCOSOFT/maths-magicians.git - for SSH
```

- Once the files are on your machine, open the _maths-magicians_ folder in your preferred code editor e.g VS Code, Atom, etc. , and follow the steps in Installation & Set Up

## 🛠 Installation & Set Up

1. Install Node Modules

```sh
npm install
```

2. Start the development server

```sh
npm start
```

3. Open [http://localhost:3000](http://localhost:3000) to view it in the browser.

## 🚀 Building and Running for Production

1. Generate a full static production build

```sh
npm run build
```

## 🚀 Testing Application

1. Test the items Counter and Comments Counter function

```sh
npm test
```

### Install

The following tools help make easier to work with sample code.

- [git](https://git-scm.com/downloads): A tool for managing source code
- [Visual Studio Code](https://code.visualstudio.com/): A source code editor
- [NVM](https://github.com/nvm-sh/nvm): A node package manager

## Authors

👤 **Kolapo Precious Akinrinlola**

- GitHub: [@LIBERCOSOFT](https://github.com/LIBERCOSOFT)
- Twitter: [@Gerfieldt](https://twitter.com/Gerfieldt)
- LinkedIn: [Kolapo Akinrinlola](https://linkedin.com/in/kolapo-akinrinlola-072097110)

👤 **Degisew**

- GitHub: [degisew](https://github.com/degisew)
- Twitter: [@DJ_etiya](https://twitter.com/Degisew-mengist)
- LinkedIn: [jegisew21](https://www.linkedin.com/in/degisew-mengist-003298802)

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](https://github.com/LIBERCOSOFT/maths-magicians/issues).

## Show your support

Give a ⭐️ if you like this project!

## 📝 License

This project is [MIT](./MIT.md) licensed.