Git Product home page Git Product logo

badreads's Introduction

BadReads

BadReads is a full-stack goodreads clone with a literary twist.

Find and read the top banned books of yesterday and today; keep track of banned books you want to read and be part of the world's largest community of banned book lovers on badreads.

A banned book is a book that has been removed from school curriculums and/or public libraries because a person or group has objected to its content.

Technologies used

  • Python
  • Javascript
  • Flask
  • React
  • Redux
  • SQLAlchemy
  • Alembic

How to run app locally

  • Run "git clone" with the copy/pasted repo link in whatever directory you want the clone to live.
  • Open the repo locally on the IDE of your choice and cd into the root directory.
  • Run pipenv install -r requirements.txt to isntall dependencies.
  • Run pipenv shell.
  • Run flask db upgrade.
  • Run flask seed all.
  • Run flask run to start the backend.
  • In a new terminal, cd into the "react-app" directory and run npm install
  • Then run npm start to start the frontend.
  • Congrats! The app should now be running locally.

WikiLinks

Feature Walkthrough

Splash Page

  • You can log in as a demo user in order to interact with the site easily by clicking the "login with demo user" button.
  • If you have already created an account, you can sign in.

image image

Home Page

  • You can view all of the banned books on the home page. Click the My Books button in the nav bar to begin creating a new banned book.

image

My Books Page

  • Click the "Add a book" button to begin creating a book! Enter the proper information (including a valid image url) and click submit to create the book.
  • The new book will appear at the top of the page, click on it in order to navigate to the book-specific page and review it.

image image

Book-by-id Page

  • Here you can click the "Write a review" button in order to make a new review for this book. Enter the proper information and click "Create Review" to save it!
  • Now, you can click on the "Add to Bookshelf" button to assign this book to one of your default bookshelves.
  • Click the book icon in the nav bar, or click the profile icon and then "Bookshelves" in the dropdown to navigate to the bookshelves page.

image image image

Bookshelves Page

  • If you check the default shelf you added the book to, it should be there!
  • Click the "Add shelf" button on the bottom left of the screen to add a custom bookshelf.
  • Click on the "All" shelf on the left of the screen, and then click the edit button above your created book in order to add it to your newly created bookshelf.
  • You have now explored the basic functionality of the BadReads site - feel free to edit/delete/create whatever else you want!\

image image image

badreads's People

Contributors

benwaldee avatar argon90 avatar jvstinejvng avatar julieyj avatar jb923 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.