Skip to content

hunterglaine/bookworm

Repository files navigation

Bookworm Bookworm

Bookworm is single-page application book database that gives avid readers the ability to search for, store, and categorize books from the GoogleBooks API into a personal bookshelf. Users can create and attend book club events, where all attendees can suggest books from their shelves, read further information about each suggested book, and ultimately vote on the book to read. The current vote count for each book is displayed to all attendees, and when voting is stopped, the book with the most votes is the one that remains.

Check out the demo here: https://www.youtube.com/watch?v=4XsmJQI-Rao

Visit the live site here: http://www.bookworm-app.com/

Table of Contents

Tech Stack

Features

Installation

Tech Stack

Backend Python 3, SQLAlchemy, Flask
Frontend JavaScript, React, HTML5, CSS3, React-Bootstrap
Database PostgreSQL
APIs Google Books

Features

Login/Logout

Login/Logout

Search for books and add to your bookshelf

Search and add books

Parouse bookshelf of saved books

Parouse bookshelf

See all upcoming/past book clubs hosted and attended

Upcoming and past events

Suggest books for book clubs

Suggest books

Vote for books

Vote for books

Installation

In order to use Bookworm, you will first need:

  • Python 3.6.9
  • PostreSQL 10.15

To install Bookworm:

Clone this repository:

$ git clone https://github.com/hunterglaine/bookworm.git

Create and activate a virtual environment:

Mac:

$ virtualenv env
$ source env/bin/activate

Windows:

$ virtualenv env --always-copy
$ source env/bin/activate

Install dependencies:

(env) $ pip3 install -r requirements.txt

Create the database:

(env) $ python3 seed_database.py

Start the server:

(env) $ python3 server.py

Now, head to http://localhost:5000/ to start curating your bookshelf and attending book clubs!

Contact

If you want to contact me you can reach me at hunterglaine@gmail.com.

Happy Reading! 📚

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published