Home
Archive what you collect — volume by volume.
MangaCollector is a full-stack web app and PWA for manga collectors who want to track every tankōbon they own, log purchase prices, surface what's missing from their shelves, and discover what's coming next — all behind a Shōjo-Noir aesthetic (ink black · hanko red · washi cream · gold leaf).
The wiki is split into three large sections, each oriented towards a different reader.
How to run, deploy, and operate MangaCollector. Read these pages if you are self-hosting the app, contributing changes, or operating it in production.
- Architecture — components, data flow, network diagram
- Quick start (Docker) — get running in under 5 minutes
- Production deployment — hardening, secrets, ops
- Local development — without Docker, hot reload
- Environment variables — exhaustive reference
- Authentication — Google OAuth and OpenID Connect setups
- Storage — S3/MinIO vs local filesystem
- Database & migrations — schema, upgrade path
How the app behaves once it's up. Read these pages if you are using MangaCollector to track your collection, or evaluating it for that purpose.
- Library & dashboard — the main view
- Adding a series — MAL search, custom entries, barcode
- Series page — bulk volume editing, MAL refresh
- Volume editing — ownership, price, store, collector flag
- Coffrets / box sets — group volumes that ship together
- Calendar & upcoming volumes — release tracking (来)
- Seals & achievements — milestone trophies
- Profile & statistics — analytics, completion, top spend
- Public profile — opt-in shareable read-only view
- Settings — themes, languages, titles, adult-content filter
- Import / export — MAL, AniList, MangaDex, Yamtrack, CSV/JSON
The companion service that powers the upcoming-volume calendar feature. Read this section if you want to host your own proxy or implement a compatible one in another language.
- Release calendar proxy — protocol — HTTP contract, examples, operational constraints
- Kanji glossary — every Japanese character that surfaces in the UI, with meaning and usage
- Troubleshooting — common operational issues
| Layer | Technology |
|---|---|
| Frontend | React 19 + Vite + Tailwind v4, offline-first PWA, Dexie/IndexedDB local cache |
| Backend | Rust + Axum 0.8 + SeaORM 1, runs from scratch Docker image (~14 MB) |
| Database | PostgreSQL 15 |
| Cache | Redis 8 (optional — degrades cleanly to no-cache) |
| Storage | S3-compatible (MinIO recommended) or local filesystem |
| Auth | Google OAuth 2.0 or any OpenID Connect provider |
| Reverse proxy | Traefik v2 (dev compose), bring-your-own in production |
| Calendar proxy | Separate Rust service, optional |
The codebase lives at github.com/Dim145/MangaCollector. The wiki source is in this repository.