Skip to content

A modern Progressive Web App for managing your physical book collection. Track reading progress, organize with custom shelves, manage series, and enjoy beautiful adaptive themes. Available as web app and Android APK

License

Notifications You must be signed in to change notification settings

YTFL/HonZuki-BookTracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

14 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ“š HonZuki: Your Personal Book Sanctuary

A modern Progressive Web App (PWA) for managing your physical book collection with cloud sync, reading progress tracking, and beautiful adaptive themes.

Version Next.js Firebase License PWA


๐ŸŒ Access the App

Web App: https://hon-zuki.vercel.app

Android App: Download HonZuki.apk and install on your Android device


๐Ÿ“– About

HonZuki is a feature-rich book management application designed for book lovers who want to organize their physical book collection digitally. Track your reading progress, organize books into custom shelves, manage series, and sync everything across all your devices.

Home Dashboard


โœจ Key Features

๐Ÿ“š Library & Series Management

  • Track books with rich metadata (author, genre, format, language, ISBN)

  • Series as first-class entities

    • Dedicated series pages
    • Progress tracking (owned vs read vs total)
    • Visual progress bars and completion percentage
    • Ongoing / Completed series status
  • Create and edit series directly from book forms

  • Smart series auto-complete and prompts

  • Grid and list views for books

Library View

Series View

Book Details

๐Ÿ“Š Statistics & Insights

  • Comprehensive stats dashboard

    • Total books, pages, authors, genres, series
    • Completion rate
  • Genre distribution chart

  • Books by reading status and format

  • Year-based reading stats (lifetime + per year)

  • Reading time estimates with configurable reading speed

Statistics

๐Ÿ” Discovery & Browsing

  • Global real-time search with highlighting

  • Advanced filtering

    • Reading status, genres, languages, publishers, shelves
  • Advanced sorting

    • Author, progress, page count
  • Browse by:

    • Authors
    • Genres
    • Series

Search

Authors View

Genres View

๐Ÿ’– Wishlist

  • Separate wishlist with full metadata support
  • One-tap move from wishlist to library
  • Search and filter wishlist items

๐Ÿ“– Custom Shelves

  • Create personalized shelves for better organization
  • Organize books by themes, reading goals, or any custom category
  • Easy shelf management and book assignment

Shelves

๐ŸŽจ Customization

  • Fully customizable themes

    • Solid and gradient accent colors
    • Gradient backgrounds
    • Theme import/export
  • Adaptive book detail backgrounds based on cover colors

  • Multiple font options

Settings

๐Ÿ’พ Data Management

  • Local-first storage (browser-based)
  • Import/export data (CSV & JSON)
  • Export library, wishlist, settings, and themes
  • No cloud sync (yet)

โž• Adding Books

  • Multiple ways to add books to your collection:
    • Search by title with automatic metadata fetching
    • Scan ISBN barcode (requires HTTPS)
    • Manual entry for complete control
  • Rich metadata support

Add Book

๐Ÿ”— Sharing (Limited)

  • Share your library, series, or custom collections
  • Create public share links (when authentication is enabled)
  • Currently limited due to authentication being disabled

Sharing

๐Ÿ” Accounts (Planned / Limited)

  • Guest usage supported
  • Authentication and cloud backup planned for future release

  • โŒ No login or registration - Authentication features are disabled
  • โŒ No cloud storage - Data is NOT saved to Firebase database
  • โŒ No cloud sync - Your data won't sync across devices
  • โŒ Sharing features disabled - Cannot create public share links
  • โœ… All core features work - Add books, track reading, organize library
  • โœ… Data saved locally - Securely stored in your browser's localStorage
  • โœ… Works offline - Fully functional without internet

๐Ÿ’ก Current Workflow:

  1. Use the app normally - all features work!
  2. Export your library regularly (Settings โ†’ Export) as backup
  3. Keep export files safe
  4. When authentication is fixed, you can import your data

โš ๏ธ Important Warnings:

  • Clearing browser data = losing your library! Export regularly!
  • Data is device-specific - Won't transfer to other devices
  • Use same browser - Data doesn't transfer between browsers on same device

Status: We're actively working on fixing authentication. Expected in v1.2.0 update.

Other Known Limitations

  • ISBN scanner requires HTTPS (camera access restriction)
  • Barcode scanning may not work on all devices or browsers
  • Some ISBN lookups may fail due to external data source availability
  • Large libraries (1000+ books) may experience slower load times

๐Ÿ—บ๏ธ Roadmap

๐Ÿ”ง Coming Soon

  • Fix authentication system
  • Reading goals and challenges
  • Book recommendations based on reading history
  • Enhanced statistics and analytics
  • Book reviews and ratings
  • Reading notes and highlights

๐Ÿ”ฎ Future Features

  • Social features (follow friends, share reviews)
  • Book clubs and group reading
  • Export to Goodreads/LibraryThing
  • Bulk ISBN import
  • Enhanced mobile app with React Native

๐Ÿค Contributing

While the source code is not publicly available, you can contribute by:

  • ๐Ÿ› Reporting bugs and issues
  • ๐Ÿ’ก Suggesting new features
  • ๐Ÿ“– Improving documentation
  • ๐ŸŒ Helping with translations
  • โญ Starring the repository if you like the app

Open an issue on GitHub to get started!


๐Ÿ“„ License

This application is provided as freeware for personal and non-commercial use.

You may:

  • โœ… Use the app for free
  • โœ… Share the APK file with others
  • โœ… Install on multiple devices

You may not:

  • โŒ Modify or reverse engineer the application
  • โŒ Use for commercial purposes without permission
  • โŒ Remove copyright notices

See the LICENSE file for complete terms and conditions.

Note: The source code is not included in this repository and remains proprietary.


๐Ÿ‘จโ€๐Ÿ’ป Author

YTFL


๐Ÿ’ฌ Support

Need help or have questions?

  • ๐Ÿ“ซ Open an issue on GitHub
  • ๐Ÿ“š Check the documentation in this README
  • ๐Ÿ” Review closed issues for solutions

๐Ÿ™ Acknowledgments

Built with amazing open-source technologies:


โญ Star History

If you find HonZuki useful, please consider giving it a star! โญ


Made with โค๏ธ for book lovers, by a book lover

Happy Reading!

About

A modern Progressive Web App for managing your physical book collection. Track reading progress, organize with custom shelves, manage series, and enjoy beautiful adaptive themes. Available as web app and Android APK

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published