Welcome to SpudHub!

SpudHub is a site where people can buy locally grown produce from farmers who have excess goods to share. Users can add, update, and delte items they'd like to sell, and users can add, edit, delete, and purchase items from their shopping cart.


Here are some quick links to our wiki pages:

MVP Feature List - List of features needed for the minimum viable product

User Stories - List of user stories for each feature

Layout Framework - List and layout of our framework routes

Database Schema - List of tables and relationships in our database

API Routes - List of API routes that will be used in our application

Wireframes - List of wireframe designs for each page


Visuals

Log In & Sign Up

Homepage

Non-logged in user

Logged In user

Shopping Cart

Product Details

Product Modal

Product Page

Product Edit and Create Forms


Technology

  • React
  • Reduc
  • JavaScript
  • Python
  • Flask
  • PostgreSQL
  • SQLAlchemy

Getting started

  1. Clone this repository (only this branch)

    git clone https://github.com/michellekontoff/spudhub.git
  2. Install dependencies

    pipenv install --dev -r dev-requirements.txt && pipenv install -r requirements.txt
  3. Create a .env file based on the example with proper settings for your development environment

  4. Setup your PostgreSQL user, password and database and make sure it matches your .env file

  5. Get into your pipenv, migrate your database, seed your database, and run your flask app

    pipenv shell
    flask db upgrade
    flask seed all
    flask run
  6. To run the React App in development, run:

    npm start

Technical Challenges

  • Using localStorage as our shopping cart was a new and a challenging implementation because we incorporated it into our store state.

Future Features

  • Search Bar
  • Reviews
  • Categories
  • Favorites