// the find
Project-Books/book-project
Book tracker web app for book lovers
A self-hosted book tracking web app built with Spring Boot + React/TypeScript. You get shelves (reading, read, to-read, did-not-finish), reading goals, tags, stats, and import from Goodreads/LibraryThing. Aimed at developers who want to host their own Goodreads replacement.
Flyway migrations are versioned and numerous (V001–V028+), so the schema has a real history you can follow and the DB state is reproducible. The auth stack is properly assembled — JWT with a custom filter chain, account lockout on bad credentials, password strength validation. Goodreads and LibraryThing import are both present, which solves the actual migration problem most people have. Test coverage spans controllers, services, and repositories with both unit and integration test annotations.
Last commit was April 2023 — over three years of no activity. The open issues and PRs are almost certainly stale, and dependencies (Spring Boot, React ecosystem) will have drifted significantly by now. The mockup screenshot in the README explicitly warns it may not match the actual UI, which is a small red flag about documentation discipline. No export to other formats beyond whatever the BookExportService does — if you want to leave, you're at the mercy of whatever CSV shape they chose. The React frontend requires running a separate Books API repo to avoid an error on the search page, so the repo isn't self-contained out of the box.