/book-project

Book tracker web app

Primary LanguageJavaGNU General Public License v3.0GPL-3.0

Logo

Build Status codecov Gitter Codacy Badge

Book tracker web app made using Spring Boot and Vaadin 14 (only the free components will be used).

Features:

  • Add books that you have read to a 'to read', 'currently reading', 'read' or 'did not finish' shelf
  • View books in your different shelves and make changes
  • A rating scale from 0-10 that that goes up in steps of 0.5
  • Track your progress towards a reading goal: the number of books or pages you hope to read by the end of the year
  • Statistics about your reading habits
  • Add your own shelves

Coming soon:

  • User registration and accounts
  • And much more!

New book form

Books in shelf

Reading goal

Reading statistics

The images above may look slightly different to the app. If major changes are made, new images will be uploaded to reflect this.

Setup

Prerequisites:

  • JDK 11 (or higher)
  • If you don't have Node.js installed globally, it is not needed as Vaadin will install it automatically
    • If you do have Node.js installed, please ensure it is at least version 10.0
  • MySQL 8.0.* or (better) Docker
    • For Windows users, install Docker Desktop and then run docker-compose up at the root of the project on the command line
  1. Clone the repository
  2. Import the project as a maven project into your favourite IDE (or run maven on the terminal)
  3. Start the MySQL Database or run the docker-compose file docker-compose up
  4. Run BookProjectApplication.java
  5. Go to localhost:8080
  6. Log in with the details below:
    • Username: user
    • Password: password

You may find lots of errors for things like the log statements, or the entities not having constructors. You can find instructions on how to fix this for IntelliJ and Eclipse in our troubleshooting wiki page. Other common errors and solutions are also detailed in the troubleshooting page.

Access database

To access the MySQL database when docker-compose is running:

  1. Go to http://localhost:8081/
  2. Log in with the settings below.
    • User Name: root
    • Password: rootpassword
  3. Click on connect

Contributing

If you wish to contribute (thanks!), please first see the contributing document.

Further information

For more information, such as a roadmap and the underlying principles of the project, see the Book Project wiki.

Help

If you need help with anything, we'll be happy to help you in our Gitter Channel.

Acknowledgements

Project Lombok - MIT License

Karibu Testing - Apache 2.0 License

Mockito - MIT License

Java Hamcrest - BSD License