{"id":19482587,"url":"https://github.com/chiomasarah/calculator-app","last_synced_at":"2026-04-12T00:07:05.925Z","repository":{"id":200126113,"uuid":"704892245","full_name":"ChiomaSarah/Calculator-App","owner":"ChiomaSarah","description":"A calculator app that allows users perform basic arithmetic operations.","archived":false,"fork":false,"pushed_at":"2023-10-15T13:57:29.000Z","size":295,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-08T07:26:24.372Z","etag":null,"topics":["mocha-chai","mongodb-atlas","node-js","react-js","react-testing-library","unit-testing"],"latest_commit_sha":null,"homepage":"https://calculator-ovpdbcvt3-chiomasarah.vercel.app/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ChiomaSarah.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-10-14T12:24:26.000Z","updated_at":"2024-12-15T15:49:03.000Z","dependencies_parsed_at":"2023-10-15T21:12:51.745Z","dependency_job_id":"3718f80f-0698-407c-a55f-9cc548664afd","html_url":"https://github.com/ChiomaSarah/Calculator-App","commit_stats":null,"previous_names":["chiomasarah/calculator-app"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChiomaSarah%2FCalculator-App","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChiomaSarah%2FCalculator-App/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChiomaSarah%2FCalculator-App/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChiomaSarah%2FCalculator-App/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ChiomaSarah","download_url":"https://codeload.github.com/ChiomaSarah/Calculator-App/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240718434,"owners_count":19846478,"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":["mocha-chai","mongodb-atlas","node-js","react-js","react-testing-library","unit-testing"],"created_at":"2024-11-10T20:11:19.313Z","updated_at":"2026-04-12T00:07:05.898Z","avatar_url":"https://github.com/ChiomaSarah.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Calculator-App\n\nA simple calculator web application built using Node.js, MongoDB, and React. This calculator allows users to perform basic arithmetic operations and displays the result. Additionally, it can save and retrieve calculation history.\n\n![image](https://github.com/ChiomaSarah/Calculator-App/assets/78868674/38bc74aa-c37b-4b6b-b37e-149ae00f7f2f)\n\n\n## Table of Contents\n\n- Features\n- Prerequisites\n- Installation\n- Usage\n- API Endpoints\n- Contributing\n- License\n\n  ## Features\n\n- Perform basic arithmetic operations (addition, subtraction, multiplication, and division).\n- Display calculation results.\n- Save and retrieve calculation history (not implemented in this example).\n- Error handling for invalid expressions and API requests.\n- Basic styling for a clean user interface.\n\n## Prerequisites\n\nBefore you begin, ensure you have met the following requirements:\n\n- Node.js is installed on your local machine.\n- MongoDB is installed and running (for persisting the history).\n- Basic knowledge of Node.js, React, and MongoDB.\n\n## Installation\n\nClone the repository:\n\n```bash\ngit clone https://github.com/ChiomaSarah/Calculator-App.git\n```\n\nNavigate to the project directory:\n\n```bash\ncd calculator-app\n```\n\nInstall backend dependencies:\n\n```bash\ncd backend\nnpm install\n```\n\nInstall frontend dependencies:\n\n```bash\ncd frontend\nnpm install\n```\n\n## Usage\n\nStart the server:\n\n```bash\ncd backend\nnpm start\n```\n\nThe server should now be running on http://localhost:9000.\n\nStart the React app:\n\n```bash\ncd frontend\nnpm start\n```\n\n## API Endpoints\n\nThe server provides the following API endpoints:\n\n- POST /calculate: Calculate arithmetic expressions.\n\nSample Request: { \"arithmeticFunction\": \"2 + 2\" }\n\nSample Response: { \"result\": 4 }\n\n- GET /history : Retrieve calculation history.\n\nResponse: An array of arithmetic operations.\n\n## Contributing\n\nFeel free to contribute to this project. You can fork the repository, make changes, and create a pull request. Please follow best practices and maintain code quality. If you encounter any issues or have ideas for improvements, open an issue on the project's GitHub repository.\n\n## License\n\nThis project is licensed under the [MIT License](https://choosealicense.com/licenses/mit/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchiomasarah%2Fcalculator-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchiomasarah%2Fcalculator-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchiomasarah%2Fcalculator-app/lists"}