HomeBranch Web v1.5.0
Multi-format reading, PDF support, and format management
What’s new
Multi-format reading
Books can now expose more than one readable format in the UI. The book details page lets readers switch between available formats, and the read flow supports EPUB and PDF from the same logical book.
Format management
Book detail actions now include linked-format management so admins can review attached files, unlink a format, or split a format back into its own book when cleanup is needed.
Reader and upload updates
The web app now includes the format-aware flows required for the current API release, including PDF upload support, richer book actions, and updated book detail behavior around attached files.
Upgrade notes
No breaking changes. Pull the latest Docker image or rebuild from source. Multi-format support requires HomeBranch API v1.4.0 — deploy both services together so the reader, upload flow, and book detail page stay in sync with the API’s format model.
Debian package upgrades preserve /etc/nginx/conf.d/homebranch.conf, so review that file when you upgrade the web frontend. The /api/ proxy should forward X-Forwarded-Proto and X-Forwarded-Prefix /api, and the SSE endpoints should keep buffering disabled. For larger PDF uploads, set client_max_body_size 200m. The Getting Started guide includes an example homebranch.conf you can copy or download.