https://github.com/luigirazum/mv-mathmagicians-app
"Math magicians" is a website for all fans of mathematics. It is a Single Page App (SPA) that allows users to: 1> Make simple calculations, and 2> Read a random math-related quote. I'm building this application to learn how to use React.
https://github.com/luigirazum/mv-mathmagicians-app
Last synced: 8 months ago
JSON representation
"Math magicians" is a website for all fans of mathematics. It is a Single Page App (SPA) that allows users to: 1> Make simple calculations, and 2> Read a random math-related quote. I'm building this application to learn how to use React.
- Host: GitHub
- URL: https://github.com/luigirazum/mv-mathmagicians-app
- Owner: luigirazum
- License: mit
- Created: 2023-03-20T18:13:53.000Z (over 2 years ago)
- Default Branch: dev
- Last Pushed: 2023-03-30T23:24:54.000Z (over 2 years ago)
- Last Synced: 2025-01-11T01:12:03.948Z (9 months ago)
- Language: JavaScript
- Size: 1.81 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
### Math Magicians
"Math magicians" is a website for all fans of mathematics. It is a Single Page App (SPA) that allows users to:
1> Make simple calculations, and
2> Read a random inspirational quote.
I'm building this application to learn how to use React.
# 📗 Table of Contents
- [📗 Table of Contents](#-table-of-contents)
- [📖 \[Math Magicians\] ](#-math-magicians-)
- [Screenshots of how the App looks.](#below-you-can-see-how-the-app-looks)
- [Watch a demo of the App working.](#below-you-can-see-how-the-app-is-working)
- [🛠 Built With ](#-built-with-)
- [Tech Stack ](#tech-stack-)
- [Key Features ](#key-features-)
- [🚀 Live Demo ](#-live-demo-)
- [💻 Getting Started ](#-getting-started-)
- [Prerequisites](#prerequisites)
- [Setup](#setup)
- [Available Scripts](#available-scripts)
- [👥 Authors ](#-authors-)
- [🔭 Future Features ](#-future-features-)
- [🤝 Contributing ](#-contributing-)
- [🙏 Acknowledgments ](#-acknowledgments-)
- [⭐ Show your support ](#-show-your-support-)
- [📝 License ](#-license-)
*[Math Magicians]* is a website for all fans of mathematics. It is a Single Page App (SPA) that allows users to:
- Make simple calculations.
- Read a random inspirational quote.
By building this application, I'm learning how to use React.
### Below you can see how the App looks.
It has a Home Page that gives the Welcome to its visitors.
a Calculator Page where you can play with the Calculator embeded.
It has a fully functional Calculator to do basic aritmethic operations.
And also a Quote Page that shows a Daily Quote to get some inspiration.
### Below you can see how the App is working.
This is a live demo of the Full Math Magicians Site working.
React
Create React App- *Single Page App (SPA), with three Pages Home, Calculator and Quotes.*
- *A fully functional Calculator embeded in the Calculator Page.*
- *DOM manipulation.*
- *It renders a Math Quote randomly.*
To get a local copy up and running, follow these steps.
### Prerequisites
- In order to run this project locally you need `git` installed. Please got to [Getting Started - Installing Git guide](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) and follow the steps described for your system to install `git`.
- You must have Node installed on our machine to access the NPM (Node Package Manager) tool.
Run `node -v` and `npm -v` in the terminal to see if you have node and npm installed, respectively. Ensure you have node>=14.0.0 and npm>=5.6\
If you don’t have them installed, head to [Node](https://nodejs.org/) to download and install the latest stable version.
### Setup
Clone this repository to your desired folder:
```sh
cd my-folder
git clone git@github.com:luigirazum/mv-mathmagicians-app.git
```
### Install
Install project dependencies with:
```sh
cd mv-mathmagicians-app
npm install
```
### Available Scripts
- #### Run
In the project directory, you can run:
```sh
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 lint errors in the console.
- #### Test
```sh
npm test
```
- Launches the test runner in the interactive watch mode.\
See the section about [running tests](https://facebook.github.io/create-react-app/docs/running-tests) for more information.
- #### Build
```sh
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.
👨💻 Luis Zubia
- GitHub: @luigirazum
- Twitter: @LuigiRazum
- LinkedIn: Luis Zubia
- [ ] *Add a Math Challenges page to have some fun.*
- [ ] *Add effects to the Calculator buttons, so you can see when they are pressed.*
In order to improve this project, contributions, issues, and feature requests are welcome!
Feel free to check the [issues page](../../issues/).
## 🙏 Acknowledgments
- 👏 I would like to thank the support of my partners, it is good to know that they are always willing to help.
I really enjoyed making this project, so, if you like it, I appreciate your support giving a ⭐.
This project is [MIT](./LICENSE) licensed.