📷 ISBN Scan & Add
Scan from phone camera or enter ISBN manually with live metadata preview.
Your private book universe.
No cloud required.
PageVault is a local, self-hosted Goodreads alternative with barcode scanning, shelves, tags, half-star ratings, CSV portability, a Plotly-powered analytics dashboard with 20+ charts, reading streaks, activity heatmaps, and robust multi-provider metadata lookup — all 100% private, no cloud required.
Highlights
🗂️ Shelves + Tags
Organize books with multi-shelf assignment and interactive genre chips.
🔎 Smart Filters
Filter by status, author, shelf, genre, or full-text query.
📊 20+ Analytics Charts
Status, genres, authors, ratings, formats, publishers, community vs personal ratings, decade distribution, and monthly trends — all filterable by date, format, and language.
⭐ Half-Star Ratings & Quotes
Rate books in 0.5-star increments, write review notes, and save favourite quotes with page numbers.
🔄 Metadata Refresh
Bulk refresh metadata while preserving your reviews, shelves, and custom tags.
📤📥 CSV Portability
Export full library and import Goodreads-compatible CSVs.
🎯 Goals, Sessions & Streaks
Set annual reading targets, log sessions with page counts and time, and track your reading streak and speed.
🔥 Activity Heatmap
GitHub-style 52-week reading calendar — see exactly when and how much you read at a glance.
📚 Series & Reading History
Track series name and number, log re-reads with dates, and record book format, DNF status, and owned/wishlist state.
📱 Mobile QR Connect
Scan a QR code on your home screen to open PageVault instantly on your phone — no typing required.
🔮 Local Recommendations
Get book suggestions based on your existing library, entirely offline.
🔐 Admin Console
Secure admin panel with password protection for diagnostics, backup, and restore operations.
🧯 Backup & Restore
One-click ZIP backup download, archive validation, and in-app restore workflow.
🧠 Metadata Fallback Chain
- Open Library Books API (primary)
- Google Books + Open Library Search + Crossref (parallel fallback)
- Open Library Covers API (cover rescue)
- In-memory ISBN TTL cache for faster bulk operations
🚀 Quick Start
- Clone:
git clone https://github.com/ChristianAbele02/PageVault.git - Install:
pip install . - Run:
python app.py - Library:
http://localhost:5000 - Stats:
http://localhost:5000/stats
🧰 Core Files
- App:
app.py— factory, wiring, entrypoint - API:
pagevault_core/api.py— all REST routes - DB:
pagevault_core/db.py— SQLite lifecycle + schema bootstrap - Metadata:
pagevault_core/metadata.py— multi-provider lookup + TTL cache - Database:
pagevault.db— your entire library in one file
🛡️ Data Safety
- Your full library lives in a single file:
pagevault.db - Back it up manually or use the in-app backup/restore flow
- Admin password is random per session unless
PAGEVAULT_ADMIN_PASSWORDis set - Coverage gate enforced in CI — must stay above 75%
Portfolio Value
🧩 Full-stack scope
Design + UX, Flask API, SQLite data model, Docker deployment, and CI quality gates in one cohesive project.
📈 Product analytics
20+ Plotly charts including reading heatmap, genre trends by year, speed per book, rating trends, time-to-finish, loan tracking, shelf breakdown, and more — with date, format and language filtering.
🧪 Engineering quality
Comprehensive automated tests and linting support stable iteration while shipping substantial product features quickly.
Example Renders (Light + Dark)
Library Grid
Light
Dark
Book covers, status badges, and progress bars directly in the shelf view.
Book Detail
Light
Dark
Detailed view with notes, multi-review timeline, and current-page progress updates.
Import / Export
Light
Dark
Goodreads-compatible CSV workflow and metadata refresh suited for real-world migration.
Built and maintained by Christian Abele.
Made with love for my wife Emili. ❤️