Math Magicians is a Single Page App (SPA) tailored for mathematics enthusiasts. It provides basic arithmetic calculations and a curated selection of inspiring and humorous math-related quotes.
MIT License
Welcome to the enchanting world of Math Magicians! Dive into the magic of numbers and fun! Prepare to be amazed as we conjure up mathematical wonders that will leave you giggling and gasping in awe. From mind-boggling calculations on our Calculator page to quotes that will tickle your funny bone on our Quote page, we've got it all! Home is where the math is, and it's full of surprises, laughter, and endless possibilities. So, fasten your seatbelts, hold on tight, and let the math magic take you on a wild and hilarious ride!
The Math Magicians project leverages the following technologies:
Math Magicians is a Single Page App (SPA) tailored for mathematics enthusiasts. It provides the following core functionalities:
To successfully run and contribute to this project, make sure you have the following:
Additionally, you might want to consider the following for an enhanced development experience:
With these prerequisites in place, you'll be well-equipped to explore, run, and contribute to Math Magicians.
To set up the Math Magicians project on your local machine, follow these steps:
git clone https://github.com/lily4178993/maths-magicians.git
cd maths-magicians
To run the Math Magicians application, you need to configure the following environment variables:
REACT_APP_QUOTES_URL
: The API URL for fetching quotes.REACT_APP_QUOTES_KEY
: The API Key for accessing the quotes API. You can obtain this API key from the API Provider.REACT_APP_QUOTES_CATEGORY
: The category of quotes you want to retrieve (e.g., 'inspirational', 'funny', 'motivational').Follow these steps to set up your environment variables:
.env
file in the project's root directory..env
file, add the necessary environment variables with their corresponding values. For example:
REACT_APP_QUOTES_URL=your-api-url-here
REACT_APP_QUOTES_KEY=your-api-key-here
REACT_APP_QUOTES_CATEGORY=your-quotes-category-here
Replace your-api-url-here
, your-api-key-here
, and your-quotes-category-here
with the actual values you obtained or want to use.////////////////////
Note: Keep these API keys and sensitive information confidential and do not commit the
.env
file to version control.////////////////////
Once you have cloned the repository and configured the environment variables, you can run the following command to install the project's dependencies:
npm install
To use the Math Magicians application, follow these steps:
Track linter errors
Track errors with the following command:
npx stylelint "**/*.{css,scss}" --fix
npx eslint "**/*.{js,jsx}" --fix
Run the Development Server:
npm start
This will start the development server.
Access the Application:
http://localhost:3000
You will now be able to interact with the Math Magicians application in your browser.
Nelly Telli
While Math Magicians is already magical, there's always room for more enchantment! Here are two exciting future features we're considering:
Interactive Math Tutorials: Introduce a new section that offers interactive math tutorials. Users can learn math concepts step-by-step through fun and engaging activities, making learning math a delightful experience.
Math Challenges and Leaderboards: Create a platform for math enthusiasts to challenge each other with math problems of varying difficulty levels. Users can solve problems, earn points, and compete on leaderboards to showcase their mathematical prowess.
These upcoming features will continue to add charm and wonder to the Math Magicians world, making it an even more captivating math playground.
Math Magicians welcomes contributions from the community. Whether you have suggestions, ideas, or bug reports, your input is valuable and can help make this project even better.
Remember, even small contributions can make a big difference!
Thank you for exploring Math Magicians! Your support means the world to us. If you find this project valuable and want to show your appreciation, here are some ways to do it:
Your support fuels our enthusiasm and keeps the magic alive in Math Magicians.
Math Magicians extends its heartfelt appreciation to the following individuals and organizations whose contributions and resources have enriched this project:
These acknowledgments reflect the collaborative spirit and support that have fueled the creation of Math Magicians. Thank you for being a part of our journey!
Math Magicians is open-source software licensed under the MIT.
The MIT License grants users the freedom to use, modify, and distribute this software while ensuring that the original authors are not liable for any issues arising from its use. For full details, please see the LICENSE file.