ShelfQuest

The ShelfQuest Digital Library project represents a mature and fully developed full‑stack application that integrates a wide array of modern technologies to deliver a seamless digital reading experience. At its core, the platform offers advanced digital library management, allowing users to upload books, organize them within personalized collections, and manage their ownership metadata. This functionality is identified in the project documentation as a central component of the client application. Complementing its management capabilities, ShelfQuest provides multi‑format reading support for both EPUB and PDF files. A distinctive component of ShelfQuest is its intelligent note‑taking and summarization system. While reading, users can create notes that are automatically stored in the dedicated notes table and enriched with concise AI‑generated summaries. These summaries are produced through a separate FastAPI‑based AI microservice integrated with the Google Gemini model, ensuring that notes remain well‑structured and contextually relevant. This feature enhances the analytical depth of the reading experience by blending user input with machine‑generated insights. Furthermore, the application includes an integrated reading session tracking mechanism that records the duration of each reading activity, updating progress continuously. To promote continued engagement, ShelfQuest implements a robust gamification and goal‑tracking framework. Users can set personal reading goals and earn achievements that are systematically tracked through the achievements and goals tables within the Supabase/PostgreSQL database. This feature not only supports self‑motivated reading but also introduces an element of interactive learning and long‑term progression. Security and user identity management are handled through a secure JWT‑based authentication system operating on the server side, while Supabase manages user accounts and profile data to maintain data integrity and privacy. As a Progressive Web App, ShelfQuest extends beyond the boundaries of traditional web applications by allowing installation on both desktop and mobile devices. Its service worker architecture ensures cached assets remain available offline, further strengthening its reliability across varying network conditions. The user interface adheres to Material Design 3 principles, delivering a clean, modern layout that dynamically adjusts to dark and light themes and adapts responsively to mobile, tablet, and desktop form factors. Combined with thoughtful design consistency, this approach guarantees a polished and intuitive user experience. Performance optimization and quality assurance are integral to ShelfQuest’s architecture. The platform employs code splitting and lazy loading to minimize load times and improve runtime efficiency. Comprehensive unit, integration, and end‑to‑end testing pipelines embedded in the repository safeguard stability and prevent regression across updates. Underpinning these systems is a well‑defined Supabase/PostgreSQL schema that includes core tables such as users, books, notes, reading_sessions, achievements, and goals. This structure serves as the backbone for key application features like note‑taking, progress analytics, and gamification, ensuring both scalability and consistency of data operations. In its entirety, ShelfQuest stands as a functional and robust cross‑platform digital library environment. Users can securely register, upload, and manage their personal book collections, read content offline in multiple formats, and enhance comprehension through AI‑driven note summaries. They can track their reading habits, pursue personalized goals, and engage in a rewarding gamified experience that makes continued learning enjoyable and measurable. By integrating advanced technologies into an accessible, performance‑oriented design, the ShelfQuest Digital Library achieves a balanced synthesis of practicality, innovation, and user empowerment.