v0.5.2

v0.5.2 - Series management, scoring improvements, and UX polish

FinalShelf v0.5.2 delivers the full M2 series feature set plus important quality improvements introduced since v0.4.2.

✨ Highlights

• Added complete Series/Cycles support: data model, scanner auto-detection, and full UI for listing, details, and book assignment.
• Improved book scoring UX with a reusable score input integrated into book details.
• Added image path fallback handling in generic lists for more reliable cover display.
• Included multiple rounds of review-driven fixes and polish for series flows and overall frontend quality.

🛠 Also included since v0.4.2

• Frontend filter wiring for book lists.
• Theme preference persistence in local storage.
• Scan progress feedback.
• Star rating display/edit support.
• Error handling improvements.
• Documentation and process updates (including versioning/testing policy improvements).

v0.4.2

FinalShelf v0.4.2 Release Notes

Release Date: March 5, 2026

Overview

v0.4.2 brings a major architectural refactor, comprehensive pagination/sorting across all list pages, new features (Read Books, Ranking), and extensive technical documentation. This release establishes a stable foundation for future development toward v1.0.

---

🎉 What's New

Backend Architecture

Unified Query Model

• Replaced fragmented QueryParams with a unified ListParams struct supporting pagination, sorting, filtering, and search
• New generic ListResponse<T> wrapper for all paginated endpoints
• All entities (books, authors, genres, lectors) now use the same standardized interface
• Consistent error handling and validation across all list commands

Impact: Reduced code duplication, easier to maintain, future-proof for new filters.

Frontend Features

Pagination & Sorting

• ✨ Pagination on all list pages: Authors, genres, lectors, search results
• ✨ Multi-field sorting: Title ↑↓, Author ↑↓, Creation date ↑↓, Score ↑↓, Books count ↑↓
• ✨ Configurable page sizes: 9, 21, 40, 66, or 99 items per page
• Unified toolbar design with consistent pagination controls across all pages

New Pages

• 🆕 Read Books page (/read) — View all books marked as read with pagination and sorting
• 🆕 Ranking page (/ranking) — Browse books sorted by your personal score (0–10)

Search Enhancements

• 🔍 Field toggles — Choose which fields to search: Title, Author, Genre, Lector
• 🔍 Pagination on results — Search results support full pagination + sorting
• 🔍 Result counter — Shows total results for the current query

Component Improvements

• 🐛 Fixed GenericListComponent — Moved @Input initialization from constructor to ngOnInit (prevents Angular lifecycle errors)
• 📝 Proper TypeScript typing — Replaced any types with specific interfaces across all components
• ♻️ OnInit implementation — All components now properly implement OnInit for predictable initialization

Code Quality

SCSS Optimization

• 📦 Global toolbar styles — Extracted pagination/sort styles to src/styles/_toolbar.scss
• Reduced component-level style duplication
• Consistent styling across genres, lectors, and search pages

Debug Cleanup

• 🧹 Removed 50+ debug console.log statements
• Cleaner browser console in development

📚 Documentation

This release includes comprehensive technical documentation:

• docs/DOCUMENTATION.md — Full technical deep-dive

  • Architecture overview
  • File & module structure
  • Database schema (with diagrams)
  • Backend & frontend key modules
  • Libraries & tech stack

• docs/plan.md — Development roadmap (v0.4.2 → v1.0)

  • 7 milestones with time estimates
  • 21 stories with acceptance criteria
  • 68 tasks with dependencies
  • Risk analysis and mitigation strategies
  • Estimated timeline: 12–19 weeks to v1.0

• README.md — Updated with current features, installation, and roadmap

v0.3.0

Overview

This PR introduces a major dashboard overhaul, enhances book list functionality, and includes important code maintenance. The changes focus on delivering new features, improving the user interface, and preparing the application for the v0.3.0 release.

What’s New

• Complete Dashboard Overhaul
• Backend Support for Dashboard
• Enhanced Book List:
• Improved Scan Function
• Code & Dependency Maintenance
• Fixed issues following a cargo update
• Resolved the majority of Rust warnings to improve code health
• Addressed bugs in the generic list component