Skip to content

A React, Tailwind and Firebase web app that save users' buying habits to make shopping suggestions.

Notifications You must be signed in to change notification settings

vivitt/despiensa-smart-shopping-list

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Despiensa

A "smart" shopping list app that learns users' buying habits and helps them remember what they are likely to need to buy on their next trip to the store.

Despiensa’s landing page

Contents


Motivation and project details

The Collab Lab supports early-career developers by providing an environment to gain practical experience through remote collaboration on real-world projects as part of an agile team.

This project is the result of the TCL-71 participation and was developed by Celine, Borja, Judith, and Viviana.

We worked on this application from February to early April 2024, using React, Tailwind, and Firebase, with Figma employed to create our app's views.

Quick start: How to use Despiensa

An email account is all that's needed to start using Despiensa. Once registered and signed in via Google, users can begin creating lists, adding items, and sharing their lists with others. Visit the following link to start using Despiensa now.

Usage: Current features

Create a list or chose one to use

When users log into the app, they are prompted to create a list if they are newcomers.

Despiensa’s All my lists view, without any list

Otherwise, they can navigate to the list they want to use.

Mark items as purchased

Once in the List view, users can interact with the items in the list. Each time a user buy the item, them mark it as purchased in the list. Over time, the app comes to understand the intervals at which users buy different items, and if an item is likely to be due to be bought soon, it rises to the top of the shopping list.

List view, filter input is empty and all list items are shown

Filter items to access them easier

Users can filter items using the input at the top.

List view, filter input contains the text "ch" and only matching items are shown

Manage List

In this view, users can manage the list they are currently using.

Add items

By clicking in the "Add item" button in the List view or in the "Manage List" link in the navigation bar, users can access the Manage List view and use the first input to add new items to their list.

Share list

By clicking in the "Share list" button in the List view or in the "Manage List" link in the navigation bar, users can access the Manage List view and use the second input to share a list with other registered users. When a list is shared with a user, they will find it in the All My List view.

Manage List view, displaying a first form to add items and a second one to share the list.

Contributing to this project

Contributions to this project are appreciated. If you find any issues or have suggestions for improvements, please feel free to submit a pull request or open an issue.

Project set up

  • clone this repo
  • npm install
  • npm start
  • navigate to localhost:3000 to see the project

Latest Long Term Support (LTS) version of Node is required to run this project locally


Made with 💜 by Celine, Borja, Judith, and Viviana.

About

A React, Tailwind and Firebase web app that save users' buying habits to make shopping suggestions.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 92.8%
  • HTML 4.1%
  • CSS 3.0%
  • Shell 0.1%