Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



14 Commits

Repository files navigation

๐Ÿ’ฐ Shopping List App ๐Ÿ›’

Shopping List App with Local Storage and Back End implementations.

Table of Content ๐Ÿ“˜

Features โœจ ๐Ÿ˜Ž

Currently, Shopping List App, both Back End and Local Storage implementations, supports the following:

  • Adding Items with Fields
    • Item
    • Quantity
    • Priority
      • Colored Priority
    • Store
    • Section
    • Price
  • Removing Specific Item(s)
  • Clearing List
  • User Session

๐Ÿ“ท Demo and Screenshots ๐Ÿ“น

Shopping List App Shopping List App
List #1 List #2
List #3 List #4


Usage ๐ŸŽฎ

This web app is written in Python 3.6 using Flask Web Framework. Frontend uses Bootstrap Framework. Local Storage version uses Javascript.

Cloning and Virtual Environment

Make sure you have Python 3.6 installed.

  • git clone
  • cd ShoppingListApp
  • python3.6 -m venv venv
  • source venv/bin/active
  • You might want to update pip using python-3.6 -m pip --upgrade pip
  • Install requirements with python3.6 -m pip install -r requirements.txt

Running the Web App

Running the Local Storage App

You can visit Shopping List App to see a live local storage version.

  • git checkout gh-pages

  • git pull

  • Run index.html

Tools ๐Ÿ‘“

Programming Languages, Frameworks, Libraries, APIs, Databases, and Data Formats.

  • Python 3
    • Flask
  • HTML & CSS
    • Bootstrap Framework
  • Javascript

Current Web App Hierarchy ๐Ÿ’ช

  • One Page Shopping App
  • More to come...

Future Plans ๐Ÿ”œ

Some of the features and functions that would be appropriate for Shopping List App. Please feel free to pick any of them and start working on improving it as a contributor.

  • General
    • Mobile Responsiveness
    • Project Structure and Cleaning
  • Features
    • Deleted Items List
    • Restore Item to Cart
  • Style/Design
    • Fonts
    • Favico
    • GitHub Corner
    • Divs & Footer
  • Marketing
    • SEO
  • Read Me
    • Add Collaborates and Contributors

Contributing ๐Ÿ”ฅ

  1. ๐Ÿ Fork this repo!
  2. Clone and cd into it
  3. Setup your virtual environment.
  4. Create your feature branch: git checkout -b my-new-feature
  5. Commit your changes: git commit -m 'Add some feature'
  6. Push to the branch: git push origin my-new-feature
  7. Submit a pull request ๐Ÿ‘

๐Ÿ•บ Collaborators & Contributors ๐Ÿ’ƒ

Ahmad M. Osman

Inspiration ๐Ÿ““

You will fail.

You will mess up.

You'll do poorly on assignments and tests.

Your side projects will not work.

Your code will be sloppy and incomplete.

You will bomb job interviews.

Your PR's will be rejected.

And because you fail, you will succeed.

Don't be afraid to fail, don't let it destroy your self-confidence, don't let it define you. Instead, do everything you can to learn from that failure and take that new knowledge into the next piece of work.

Indeed, failure is the only path to success.

    โ€• Stranger on the Internet.

License ๐Ÿ“š

Shopping List App is an open source project under MIT license.