How sukundev/matane works
Matane is a cross-platform desktop manga reader. The principal workflow is to browse extension-provided sources, open a manga, read its chapters, and retain progress; chapters can also be downloaded for offline reading. The renderer communicates with Electron’s main process through typed IPC, where domain services coordinate extensions, persistence, images, and downloads. The README documents additional branches including library updates, history, backups, statistics, settings, and extension-repository management. Some subsystem details are documented rather than sampled, so their links are shown only where evidence supports them.
Main entry points: sources.ts Source browsing · chapters.ts Chapter repository · extensions/service.ts Extension service · images/service.ts Image service and cache
Components 23
Desktop interface
- Renderer and routes
apps/desktop/src/renderer/src/main.tsx
Manga workflows
- Typed IPC handlers
apps/desktop/src/main/ipc/handlers.ts - IPC contract
packages/shared/src/ipc/contract.ts - Source browsing
apps/desktop/src/main/extensions/sources.ts - Library service
apps/desktop/src/main/library/service.ts - Reading progress
apps/desktop/src/main/reading/service.ts - Download manager
apps/desktop/src/main/downloads/manager.ts - Library updates
apps/desktop/src/main/library/updates.ts - Backup service
apps/desktop/src/main/backup/service.ts - Reading statistics
apps/desktop/src/main/stats/service.ts
Extension ecosystem
- Extension service
apps/desktop/src/main/extensions/service.ts - Sandbox host
apps/desktop/src/extension-host/host.ts - Extension runtime
packages/extension-runtime/src/runtime.ts - Extension SDK
packages/extension-sdk/src/index.ts - Extension networking
apps/desktop/src/main/network/manager.ts
Persistence and media
- Manga repository
apps/desktop/src/main/db/repositories/manga.ts - Chapter repository
apps/desktop/src/main/db/repositories/chapters.ts - Download repository
apps/desktop/src/main/db/repositories/downloads.ts - Image service and cache
apps/desktop/src/main/images/service.ts - Shared domain models
packages/shared/src/models.ts - Settings schema
packages/shared/src/settings.ts
Other components
- Matane user
- Extension content sites
Connections 28
- Matane user → Renderer and routes: uses
README.md - Renderer and routes → Typed IPC handlers: invokes
apps/desktop/src/renderer/src/main.tsx - Typed IPC handlers → IPC contract: implements
apps/desktop/src/main/ipc/handlers.ts - Typed IPC handlers → Source browsing: dispatches
apps/desktop/src/main/ipc/handlers.ts - Source browsing → Extension service: calls
apps/desktop/src/main/extensions/sources.ts - Extension service → Extension networking: requests
apps/desktop/src/main/extensions/service.ts - Extension networking → Extension content sites: fetches
README.md - Extension service → Sandbox host: uses sandbox
apps/desktop/src/main/extensions/service.ts - Sandbox host → Extension runtime: hosts
- Extension service → Extension runtime: runs extensions
apps/desktop/src/main/extensions/service.ts - Source browsing → Manga repository: stores listings
apps/desktop/src/main/extensions/sources.ts - Source browsing → Chapter repository: syncs chapters
apps/desktop/src/main/extensions/sources.ts - Library service → Source browsing: refreshes manga
apps/desktop/src/main/library/service.ts - Library service → Manga repository: reads manga
apps/desktop/src/main/library/service.ts - Library service → Chapter repository: lists chapters
apps/desktop/src/main/library/service.ts - Download manager → Download repository: tracks jobs
apps/desktop/src/main/downloads/manager.ts - Download manager → Chapter repository: loads chapters
apps/desktop/src/main/downloads/manager.ts - Download manager → Image service and cache: gets pages
apps/desktop/src/main/downloads/manager.ts - Reading progress → Chapter repository: uses chapter data
apps/desktop/src/main/reading/service.ts - Library updates → Source browsing: checks sources
- Backup service → Shared domain models: serializes data
apps/desktop/src/main/backup/service.ts - Reading statistics → Manga repository: reads manga
apps/desktop/src/main/stats/service.ts - Image service and cache → Manga repository: loads manga
apps/desktop/src/main/images/service.ts - Image service and cache → Chapter repository: loads chapters
apps/desktop/src/main/images/service.ts - Image service and cache → Extension runtime: restores images
apps/desktop/src/main/images/service.ts - Extension SDK → Extension runtime: defines extension API
packages/extension-runtime/src/runtime.ts - IPC contract → Shared domain models: uses models
packages/shared/src/ipc/contract.ts - IPC contract → Settings schema: uses settings
packages/shared/src/ipc/contract.ts