Skip to content

A Spring Boot application that allows users to register, browse books from Open Library, track reading progress and rate books.

Notifications You must be signed in to change notification settings

yomostova/readery

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Readery 📚

This is a minimalistic book tracker, a tool that helps find your books and keep an eye on the reading progress. Main components are:

  • Java Backend (Spring Boot, Spring Security)
  • PostgreSQL database (integrated with Hibernate)
  • Frontend with HTML/CSS templates processed by Thymeleaf

Getting started

1. Clone the repository

git clone https://github.com/yomostova/readery.git

2. Download Open Library data to populate the database.
https://openlibrary.org/developers/dumps - we need works dump and authors dump

3. Create a PostgreSQL database named 'readery' (Documentation on creating a database)[https://www.postgresql.org/docs/current/manage-ag-createdb.html]

4. Update application.properties with your information

  • datadump.location.authors= path to the downloaded authors dump
  • datadump.location.works= path to the downloaded works dump
  • spring.datasource.username= username for your postgresql database
  • spring.datasource.password= password for the database
  • initDB.ebabled= set false by default. Change it to true to insert data into database for the first time or if you want to populate the database with new data.

5. Run application

./gradlew build
./gradlew run

Check out the website at http://localhost:8080/.

Functionality

1. Sign up and log into your account

drawing

drawing drawing

2. Search through a catalogue of books from Open Library

drawing drawing

3. Track the status of your books

Set start and finished dates, rating, add books to your wishlist or set status to reading, read or unfinished.

drawing drawing

4. Look through the books you've interacted with on the home page

drawing

🔹 current TODO: add navigation by author (author's page)

About

A Spring Boot application that allows users to register, browse books from Open Library, track reading progress and rate books.

Topics

Resources

Stars

Watchers

Forks