{"id":21199158,"url":"https://github.com/nitbravoa92/math-magicians","last_synced_at":"2025-09-28T14:31:50.623Z","repository":{"id":178421408,"uuid":"661830983","full_name":"NitBravoA92/math-magicians","owner":"NitBravoA92","description":"Webapp built with ReactJS. It shows a calculator that solves basic mathematical operations and displays a famous Quote using Ninja API to inspire the users.","archived":false,"fork":false,"pushed_at":"2023-08-05T20:26:39.000Z","size":1866,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"dev","last_synced_at":"2025-01-13T14:54:54.947Z","etag":null,"topics":["css3","html5","javascript","jest-tests","react","react-hooks","react-router","reactjs"],"latest_commit_sha":null,"homepage":"https://math-magicians-app-z9yt.onrender.com/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NitBravoA92.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-03T18:49:58.000Z","updated_at":"2023-08-25T00:28:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"f36a15d3-3cfa-4153-b49b-79f9dfaa3503","html_url":"https://github.com/NitBravoA92/math-magicians","commit_stats":null,"previous_names":["nitbravoa92/math-magicians"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NitBravoA92%2Fmath-magicians","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NitBravoA92%2Fmath-magicians/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NitBravoA92%2Fmath-magicians/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NitBravoA92%2Fmath-magicians/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NitBravoA92","download_url":"https://codeload.github.com/NitBravoA92/math-magicians/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234530599,"owners_count":18847680,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["css3","html5","javascript","jest-tests","react","react-hooks","react-router","reactjs"],"created_at":"2024-11-20T19:57:04.867Z","updated_at":"2025-09-28T14:31:50.235Z","avatar_url":"https://github.com/NitBravoA92.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003cbr/\u003e\r\n  \u003ch2\u003e\u003cb\u003eMath Magicians WebApp\u003c/b\u003e\u003c/h2\u003e\r\n\u003c/div\u003e\r\n\r\n# 📗 Table of Contents\r\n\r\n- [📗 Table of Contents](#-table-of-contents)\r\n- [Math Magicians WebApp](#math-magicians-webapp)\r\n  - [🛠 Built With ](#-built-with-)\r\n    - [Tech Stack ](#tech-stack-)\r\n    - [Key Features ](#key-features-)\r\n    - [🚀 Live Demo ](#-live-demo-)\r\n  - [💻 Getting Started ](#-getting-started-)\r\n    - [Setup](#setup)\r\n    - [Prerequisites](#prerequisites)\r\n    - [Install](#install)\r\n    - [Usage](#usage)\r\n    - [Build](#build)\r\n  - [👥 Authors ](#-authors-)\r\n  - [🔭 Future Features ](#-future-features-)\r\n  - [🤝 Contributing ](#-contributing-)\r\n  - [⭐️ Show your support ](#️-show-your-support-)\r\n  - [🙏 Acknowledgments ](#-acknowledgments-)\r\n  - [📝 License ](#-license-)\r\n\r\n# Math Magicians WebApp\u003ca name=\"about-project\"\u003e\u003c/a\u003e\r\n\r\n**Math Magicians** This project consists of building a webapp with the ReactJS library, to show a calculator that solves the main mathematical operations (addition, subtraction, multiplication, division, percentages). This webapp will consist of 3 pages, which will provide information about the website, show the calculator and a series of quotes about Mathematics so that users can explore more of the world of mathematics.\r\n\r\n## 🛠 Built With \u003ca name=\"built-with\"\u003e\u003c/a\u003e\r\n\r\n### Tech Stack \u003ca name=\"tech-stack\"\u003e\u003c/a\u003e\r\n\r\n\u003cdetails\u003e\r\n  \u003csummary\u003eClient\u003c/summary\u003e\r\n  \u003cul\u003e\r\n    \u003cli\u003e\u003ca href=\"https://es.react.dev\"\u003eReactJS\u003c/a\u003e\u003c/li\u003e\r\n    \u003cli\u003e\u003ca href=\"https://reactrouter.com/en/main\"\u003eReact Router\u003c/a\u003e\u003c/li\u003e\r\n    \u003cli\u003e\u003ca href=\"https://nodejs.org\"\u003eNode.js\u003c/a\u003e\u003c/li\u003e\r\n    \u003cli\u003e\u003ca href=\"https://create-react-app.dev\"\u003eCreate React App\u003c/a\u003e\u003c/li\u003e\r\n    \u003cli\u003e\u003ca href=\"https://stylelint.io/\"\u003eStylelint.io\u003c/a\u003e\u003c/li\u003e\r\n    \u003cli\u003e\u003ca href=\"https://eslint.org/\"\u003eESlint.org\u003c/a\u003e\u003c/li\u003e\r\n    \u003cli\u003e\u003ca href=\"https://jestjs.io/docs/getting-started\"\u003eJest\u003c/a\u003e\u003c/li\u003e\r\n    \u003cli\u003e\u003ca href=\"https://testing-library.com/docs/react-testing-library/intro/\"\u003eReact Testing Library\u003c/a\u003e\u003c/li\u003e\r\n  \u003c/ul\u003e\r\n\u003c/details\u003e\r\n\r\n### Key Features \u003ca name=\"key-features\"\u003e\u003c/a\u003e\r\n\r\n- **Using the ReactJS library**\r\n- **Using the ReactJS Router library**\r\n- **Using JSX syntax**\r\n- **Use of semantic HTML**\r\n- **SPA Approach**\r\n- **Responsive Design**\r\n- **Unit test with jest and React Testing Library**\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n\r\n### 🚀 Live Demo \u003ca name=\"live-demo\"\u003e\u003c/a\u003e\r\n\r\nTo see the application working live, you can click on the following link that contains the demo version:\r\n\r\n- [Math Magicians - Live Demo](https://math-magicians-app-z9yt.onrender.com/)\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n\r\n## 💻 Getting Started \u003ca name=\"getting-started\"\u003e\u003c/a\u003e\r\n\r\nTo get a local copy up and running, follow these steps.\r\n\r\n### Setup\r\n\r\nClone this repository to your desired folder:\r\n\r\n```sh\r\n  cd my-folder-name\r\n  git clone git@github.com:NitBravoA92/math-magicians.git\r\n```\r\n\r\n### Prerequisites\r\n\r\nIn order to install, modify and run this project, it is necessary to have the following applications installed:\r\n\r\n- **Git:** to manage the project versions of source code. [You can Download Git here](https://git-scm.com/)\r\n\r\n- **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)\r\n\r\n- **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/)\r\n\r\nIt 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. \r\n- [Learn the basics of HTML](https://developer.mozilla.org/en-US/docs/Web/HTML)\r\n- [Learn the basics of CSS](https://developer.mozilla.org/en-US/docs/Web/CSS)\r\n- [JavaScript basics](https://developer.mozilla.org/en-US/docs/Learn/Getting_started_with_the_web/JavaScript_basics)\r\n- [Javascript Arrays](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Array)\r\n- [Javascript Objects](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)\r\n- [JavaScript modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules)\r\n- [ReactJS](https://react.dev/learn)\r\n- [JSX](https://react.dev/learn/writing-markup-with-jsx)\r\n- [Create React App](https://github.com/facebook/create-react-app)\r\n\r\n\r\n### Install\r\n\r\nInstall this project by running the next command into your project folder:\r\n\r\n```sh\r\n  npm install\r\n```\r\n\r\nAll 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.\r\n\r\n### Usage\r\n\r\nIn the project directory, you can run:\r\n\r\n- `npm start`\r\n\r\nRuns the app in the development mode.\\\r\nOpen [http://localhost:3000](http://localhost:3000) to view it in your browser.\r\n\r\nThe page will reload when you make changes.\\\r\n\r\n\r\nYou may also see any CSS and JS linters errors in the console running the following commands:\r\n\r\nCSS Linter\r\n```sh\r\n  npx stylelint \"**/*.{css,scss}\"\r\n```\r\n\r\nJavascript Linter\r\n```sh\r\n  npx eslint \"**/*.{js,jsx}\"\r\n```\r\n\r\n### Build\r\n\r\n- `npm run build`\r\n\r\nBuilds the app for production to the `build` folder.\\\r\nIt correctly bundles React in production mode and optimizes the build for the best performance.\r\n\r\nThe build is minified and the filenames include the hashes.\\\r\nYour app is ready to be deployed!\r\n\r\nSee the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.\r\n\r\n\r\n**Note**: Please only modify the components files like App.js, testing files like App.test.js and the CSS files. Do not modify configurations files of the project.\r\n\r\n\r\n## 👥 Authors \u003ca name=\"authors\"\u003e\u003c/a\u003e\r\n\r\n👤 **Nitcelis Bravo**\r\n\r\n- GitHub: [Nitcelis Bravo](https://github.com/NitBravoA92)\r\n- Twitter: [@softwareDevOne](https://twitter.com/softwareDevOne)\r\n- LinkedIn: [Nitcelis Bravo Alcala](https://www.linkedin.com/in/nitcelis-bravo-alcala-b65340158)\r\n\r\n👤 **Reza Merzaie**\r\n\r\n- GitHub: [Reza Merzaie](https://github.com/Gh-Reza)\r\n- LinkedIn: [Reza Merzaie](https://www.linkedin.com/in/reza-merzaie-b94368202/)\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n## 🔭 Future Features \u003ca name=\"future-features\"\u003e\u003c/a\u003e\r\n- [x] **Create the UI of the Calculator component**\r\n- [x] **Create the Calculator component basic functionality**\r\n- [x] **Create the Home page to show the main information about the webapp**\r\n- [x] **Create the Calculator page to show the Calculator component**\r\n- [x] **Create the Quote page to show some Maths quotes**\r\n- [x] **Create Unit Tests to validate the operation of the application components**\r\n- [ ] **Improve UI design using TailwindCSS**\r\n- [ ] **Add custom informative texts in paragraphs**\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n## 🤝 Contributing \u003ca name=\"contributing\"\u003e\u003c/a\u003e\r\n\r\nContributions, issues, suggestions and feature requests are welcome!\r\nFeel free to check the [issues page](../../issues/).\r\n\r\nTo 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)\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n## ⭐️ Show your support \u003ca name=\"support\"\u003e\u003c/a\u003e\r\n\r\nIf 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.\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n## 🙏 Acknowledgments \u003ca name=\"acknowledgements\"\u003e\u003c/a\u003e\r\n\r\nI would 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.\r\n\r\n\r\n## 📝 License \u003ca name=\"license\"\u003e\u003c/a\u003e\r\n\r\nThis project is [MIT](./LICENSE) licensed.\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnitbravoa92%2Fmath-magicians","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnitbravoa92%2Fmath-magicians","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnitbravoa92%2Fmath-magicians/lists"}