ab-noori / math-magicians

"Math magicians" is a website for mathematics fans. It is a Single Page App (SPA) created using ReactJS library, that allows users to make simple calculations and read a random math-related quote.

Math Magicians

Desktop Veiw Representation

📗 Table of Contents

• 📖 About the Project
  • 🛠 Built With
    • Tech Stack
    • Key Features
  • 🚀 Live Demo
• 💻 Getting Started
  • Setup
  • Prerequisites
  • Install
  • Usage
  • Run tests
  • Deployment
• 👥 Authors
• 🔭 Future Features
• 🤝 Contributing
• ⭐️ Show your support
• 🙏 Acknowledgements
• ❓ FAQ (OPTIONAL)
• 📝 License

📖 [Math Magicians]

[Math Magicians] is a website for mathematics fans. It is a Single Page App (SPA) that allows users to make simple calculations and read a random design-related quote.

🛠 Built With

Tech Stack

• Client
  • HTML
  • CSS
  • JavaScript
  • ReactJS
  • API

Key Features

• [Responsive layout]
• [UX/UI accessibility]
• [Dynamic data]

(back to top)

🚀 Live Demo

• Live Demo on Gh-pages
• Live Demo on Render

(back to top)

💻 Getting Started

To get a local copy up and running, follow these steps:

Prerequisites

In order to run this project you need:

• A browser of you choice.
• A text editor of your choice.
• An installed node.js on your local system

Setup

Clone this repository to your desired folder:

• Use the following Commands:

  cd your-desired-folder
  git clone [email protected]:ab-noori/math-magicians.git
  

Install

• Install this project with:

   npx create-react-app my-app
   cd my-app
   npm start
  

Usage

• Use following commands to run on your local system:

  npm run build
  npm run deploy
  

Run tests

• Run the following script and style test:

  npx eslint "**/*.{js,jsx}"
  npx eslint "**/*.{js,jsx}" --fix
  
  npx stylelint "**/*.{css,scss}"
  npx stylelint "**/*.{css,scss}" --fix
  

Deployment

• You can deploy this project using:

  npm run build
  gh-pages -d build
  

(back to top)

👥 Authors

👤 Abdul Ali Noori

• GitHub: @ab-noori
• Twitter: @AbdulAliNoori4
• LinkedIn: abdul-ali-noori

🔭 Future Features

• [Add About page]
• [Add Contact page]

(back to top)

🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

(back to top)

⭐️ Show your support

If you like this project, give it a star.

(back to top)

🙏 Acknowledgments

I would like to thank Microverse and my coding partners, and a Micronaut, Miss Kanza Tahreem, she has done amazing projects, I inspired from her project for this project. also I want to give credit to Nerd's lesson YouTub Channel, it's react tutorial is really helpfull.

(back to top)

❓ FAQ (OPTIONAL)

• How to make it mobile friendly?

  • Put a viewport tag in the header

• How to design the site?

  • Draw a mockup before start to code

(back to top)

📝 License

This project is MIT licensed.

(back to top)