Skip to content
/ books Public

At Kabisa we read books. And we read a lot of books. Get inspired by finding out which books we read and like the best...

Notifications You must be signed in to change notification settings

kabisa/books

Repository files navigation

Books

Introduction

...

Prerequisites

  • Install all requirements on your machine
  • brew install graphviz
  • brew install imagemagick
  • brew install firefox (for running cucumber tests)

Installation

$ git clone https://github.com/kabisa/books
$ cd books
$ rbenv install `cat .ruby-version` # assuming you use rbenv.
$ bundle install
$ yarn install
$ bin/rails db:setup

Running / Development

Populate the database

The project comes with a seed.rb which you can use to populate your development environment:

$ bin/rails db:seed [USERS_COUNT=n] [BOOKS_COUNT=m]

Running tests

$ bin/rails ci

Technical details

Class diagram

erd.svg

To update the diagram, run the following command:

$ bin/rails erd

Daemonite's Material UI

Since I never used Material Design before, I thought this project would make a good candidate. For this I used Daemonite's Material UI, which uses Bootstrap with some customizations added to it. Instructions on how to use Daemonite's Material UI in a Rails project can be found here.

Font Awesome

Font Awesome has a gem available for including FA in a Rails project. Instead this project used yarn for installing the FA package, since relies on the asset pipeline.

I did copy the view helper from this gem and renamed it from icon to fa_icon

SendGrid

The production version of this application uses SendGrid for sending mails.

S3

In some environments images are uploaded to an S3 bucket using CarrierWave. If you want to use this feature, make sure you have an S3 bucket created and add the required keys to the corresponding ENV variables:

  • AWS_ACCESS_KEY_ID
  • AWS_SECRET_ACCESS_KEY
  • AWS_REGION
  • AWS_BUCKET_NAME

Fallback cover image

Generated using https://dummyimage.com/200x300/212121/fafafa.png&text=No+Cover+Available

Deployment

The application is hosted by Heroku (staging and production). Instruction about the deployment process can be found here.

Build Status

About

At Kabisa we read books. And we read a lot of books. Get inspired by finding out which books we read and like the best...

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published