The goal of this version of GrocerEase is to further collaborate and learn from Team 77's Collab Lab project, a “smart” shopping list app that learns your buying habits and helps you remember what you’re likely to need to buy on your next trip to the store. We hope to refactor the code to be more accessible, scalable, and optimized for better performance. All in the name of learning and having fun!
As a user, you will enter items (e.g., “Greek yogurt” or “Paper towels”) into your list. Each time you buy the item, you mark it as purchased in the list. Over time, the app comes to understand the intervals at which you buy different items. If an item is likely to be due to be bought soon, it rises to the top of the shopping list.
The app will work in many of the same ways as iNeedToBuy.xyz (on which our project is based) with the exception that we will not be implementing barcode scanning (that feature would add a lot of scope to the project and wasn’t all that useful).
📺 Check out a video demo of the example app here:
npm is distributed with Node.js, which means that when you download Node.js, you automatically get npm installed on your computer. You can install Node by downloading it from the Node.js website or using a Node version manager like nvm on a macOS or Linux device or nvm-windows on a Windows device.
💡 Note: This project requires the latest Long Term Support (LTS) version of Node. If you have an earlier version of Node, now would be a great time to upgrade!
On GitHub, navigate to the repo for your cohort’s project (you’re probably there right now), then:
- Click on the "Code" tab. It may already be selected.
- Click the green "Code" button to reveal a "Clone" popup.
- The "HTTPS" tab should be automatically selected. If not, click "HTTPS."
- Click the copy button to copy the url of this repository to your clipboard.
From your terminal, cd into the directory where you want this project to live.
Once you’re in the directory, type git clone followed by the web URL you just copied to your clipboard from GitHub. Then cd into the directory that is created.
Once you’ve cloned the project locally and you’re in the project directory, you’ll want to install the project’s dependencies. To do so, type the following into your terminal: npm ci
After you’ve cloned the project locally and updated the dependencies, run the project by typing the following into your terminal: npm start. You should be able to see the project at localhost:3000.
🎉 You did it! You’re ready to start contributing!