Skip to content

Dallas-iKe/groceryApp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Grocery List App

Overview

The Grocery List App is a simple and intuitive application that helps users manage their grocery shopping. This app allows users to add items to their grocery list, mark items as completed when purchased, delete individual items, search through the list, and see a total count of items on their list. It's designed to make grocery shopping more organized and efficient.

Features

  • Add Items: Easily add items to your grocery list.
  • Check Items: Mark items as completed when you've purchased them.
  • Delete Items: Remove individual items from your list.
  • Search Function: Quickly search through your list to find specific items.
  • Total Item Count: Displays the total number of items on your grocery list.

Screenshot

Grocery List App Screenshot

Getting Started

Follow these instructions to set up and run the Grocery List App on your local machine.

Prerequisites

  • Node.js: Make sure you have Node.js installed on your machine. You can download it from here.

Installation

  1. Clone the Repository:
    git clone https://github.com/Dallas-iKe/groceryApp.git
  2. Navigate to the Project Directory:
    cd groceryApp
  3. Install Dependencies:
    npm install
  4. Start the Application:
    npm start

The app should now be running on http://localhost:3000.

Usage

  1. Adding Items:

    • Enter the name of the item in the input field and click the Add Item button (or press Enter) to add it to your list.
  2. Checking Items:

    • Once you have purchased an item, click on the checkbox next to the item to mark it as completed.
  3. Deleting Items:

    • To remove an item from your list, click the Delete button (trash can icon) next to the item.
  4. Searching Items:

    • Use the search bar to filter items on your list. The list will dynamically update to show only the items that match your search term.
  5. Total Item Count:

    • The total number of items in your list is displayed at the bottom of the list, helping you keep track of how many items you need to buy.

Contributing

Contributions are welcome! If you'd like to contribute to this project, please fork the repository and use a feature branch. Pull requests are warmly welcome.

  1. Fork the Repository
  2. Create Your Feature Branch:
    git checkout -b feature/YourFeature
  3. Commit Your Changes:
    git commit -m 'Add some feature'
  4. Push to the Branch:
    git push origin feature/YourFeature
  5. Open a Pull Request

Contact

For any questions or suggestions, feel free to open an issue or contact me directly through email

About

Grocery List App

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors