How zpaolo11x/mangabox works
MangaBox is a web-technology client for Komga, deployed as a web/PWA, Electron desktop app, or Capacitor mobile app. The principal workflow is to authenticate with a Komga server, browse libraries and series, select a book, and read it. The README also documents filtering, global search, reading controls, thumbnails, themes, and offline books. The excerpts show authentication and Electron offline-book handling; UI feature links not visible in sampled source are documented by the README, so unsampled implementation details are not inferred.
Main entry points: index.html Library browser · script-auth.js Server login · package-main.js Electron main process · package-preload.js Preload bridge
Components 19
Access and authentication
- MangaBox client
index.html - Server login
script-auth.js - Credential storage
package-preload.js
Library discovery
- Dashboard
index.html - Library browser
index.html - Library filters
index.html - Global search
index.html - Series details
index.html - Book selection
index.html
Reading experience
- Reading mode
index.html - Page thumbnails
index.html - Read controls
index.html - Themes and layout
style-mangabox-reader.css
Runtime and offline
- Transliteration map
script-transliterate.js - Electron main process
package-main.js - Offline book files
package-main.js - Preload bridge
package-preload.js
Other components
- Reader
- Komga server
Connections 18
- Reader → MangaBox client: uses
README.md - MangaBox client → Server login: authenticates through
README.md - Server login → Komga server: checks session
script-auth.js - Server login → Credential storage: loads credentials
script-auth.js - Reader → Dashboard: opens
README.md - Dashboard → Library browser: browses
README.md - Library browser → Library filters: filters
README.md - Library browser → Global search: searches
README.md - Library browser → Series details: opens series
README.md - Series details → Book selection: selects book
README.md - Book selection → Reading mode: opens reader
README.md - Reading mode → Page thumbnails: previews pages
README.md - Reading mode → Read controls: updates read state
README.md - Reading mode → Themes and layout: uses reading layout
README.md - Reader → Transliteration map: uses text conversion
- Preload bridge → Electron main process: bridges IPC
package-preload.js - Electron main process → Komga server: downloads book data
package-main.js - Electron main process → Offline book files: writes and reads
package-main.js