Skip to content

jonahkimm/MenuMap

Repository files navigation

GitHub contributors GitHub forks GitHub stars GitHub open issues Licence

MenuMap

MenuMap is a web application project that uses restaurant/dish🍔 curation and maps🗺️ to empower people who may have felt restricted in their diets to expand and experience foreign cuisines and support businesses near them📈.

MenuMap caters to a diverse user base, from students👩🏻‍🎓 on a budget to adventurous eaters looking for a great recommendation. The app will take inputs🔤 from the user such as desired price range, type of cuisine and dietary restrictions to filter nearby restaurants and display the choices on an interactive map📍.

Link to website not available (ran out of credits)

Contents

  1. Getting Started
  2. Tech Stack
  3. Application Features
  4. Licence
  5. Acknowledgements

Getting Started

To setup the project locally, follow the instructions below-

Prerequisites

  • npm
    if not already installed, refer to the installation guide🔗
    after installation, run the following command to validate-
    npm --version

Installation

  1. Clone the repository using the following command-

    git clone git@github.com:jonahkimm/MenuMap.git
  2. Install required packages

    npm install 
  3. Run the Application

    npm start

Tech Stack

HTML
HTML is the backbone of the web, providing a standardized markup language understood by all browsers. Its structured approach enhances accessibility, SEO, and content readability. We have used it to construct the body of our application.

CSS
Tailwind CSS utilizes a utility-first methodology, allowing for rapid development by applying small, single-purpose classes directly in the HTML. This approach speeds up the styling process and encourages consistency.

React
React.js follows a component-based architecture, allowing developers to build UIs by breaking them down into reusable components. This modularity enhances code reusability, maintainability, and scalability. Collectively, we are most familiar with React. It is also an industry staple thus, has a lot of support in the open-source market as well.

Jest
Jest is known for its simplicity and ease of adoption. It comes with an intuitive API that allows developers to write tests quickly and efficiently. Jest supports different types of tests, including unit, integration, and end-to-end tests. Its versatility allows for comprehensive test coverage across the application stack. It was also suggested to us by our instructor taking into account our overall tech stack and hence, we decided to use it.

GithubActions
GitHub Actions automates various workflows, including continuous integration and deployment. It allows you to build, test, and deploy code automatically, streamlining the development pipeline. As GitHub's native CI/CD solution, GitHub Actions seamlessly integrates with repositories and pull requests.

Netlify
Netlify simplifies the deployment process by providing an intuitive interface where developers can easily deploy static sites or applications directly from their Git repositories. Continuous deployment is automated, triggered by repository updates. Moreover, we decided to use it since it's free.

Application Features

  1. Filtering
    preset options to filter on the basis of dietary restrictions, allergies, health stats and display recommendations
  1. Dish Recommendations
    this feature is especially curated for adventurous eaters ;)
  1. Dish Explanations
    displays a short summary of what the dish is and some health stats
  1. Nearby Restaurants
    pins nearby restaurants on a map with a brief summary of what they offer
  1. Restaurant Info
    provides a link to restaurant website, their contact number & many more :)
  1. Filtering Based on Location displays nearby restaurants on the basis of location input.

Licence

Distributed under the MIT License. See LICENSE for more information.

Acknowledgements

  1. AI Declaration Forms
    Milestone1
    - Jonah Kim
    - Aarham Haider
    - Jeet Patel
    - Aryaman Bahuguna

    Milestone2
    - Jonah Kim
    - Aarham Haider
    - Jeet Patel
    - Aryaman Bahuguna

  2. Resources
    Documentation
    Youtube

About

WebApp that helps you discover great food around you!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors