How ok/mirall works
Mirall is a local-first Electron desktop client for private, peer-to-peer file sharing and resumable transfers. A user creates or joins a cryptographically protected space, approves members, shares files or folders, and chooses what to download or mirror. The renderer presents spaces and transfer state; Electron hosts a Bare worker that owns the data layer and exposes requests to the UI. The README documents the peer network and security model; sampled source clarifies selected IPC and storage paths, but most domain implementations were not sampled, so uncertain links are omitted.
Main entry points: main.js Worker entry · network Encrypted peer network · ipc.js IPC handlers · space.js Spaces and membership
Components 20
Desktop interface
- Screens and navigation
src/renderer/screens - Query cache
src/renderer/store/query-store.js - Renderer IPC
src/renderer/ipc/ipc.ts
Electron host
- App lifecycle
src/main/main.js - Worker host
src/main/worker-host.js - Worker entry
src/worker/main.js - IPC handlers
src/shared/core/ipc.js - Request contracts
src/shared/contract/requests.js - Storage requests
src/worker/ipc/storage.js
Spaces and identity
- Worker bootstrap
src/worker/boot.js - Spaces and membership
src/shared/spaces/space.js - Identity and profile
src/shared/spaces/profile.js - Storage accounting
src/shared/storage/storage.js
Sharing and transfers
- Folder publishing
src/shared/folders/publish-service.js - Share catalog
src/shared/shares/shares.js - Content transfers
src/shared/transfer/overlay/engine/transfer/transfer-manager.js - Folder mounts
src/shared/folders
Peer network
- Encrypted peer network
src/shared/network - P2P updates
src/main/updater.js
Other components
- User
Connections 21
- User → Screens and navigation: uses
README.md - Screens and navigation → Query cache: queries
- Query cache → Renderer IPC: fetches through
src/renderer/store/query-store.js - Renderer IPC → IPC handlers: requests
- App lifecycle → Worker host: starts
src/main/main.js - Worker host → Worker entry: hosts
README.md - Worker entry → Worker bootstrap: bootstraps
src/worker/main.js - Worker entry → IPC handlers: creates
src/worker/main.js - IPC handlers → Request contracts: validates requests
src/shared/core/ipc.js - Worker entry → Storage requests: registers
src/worker/main.js - Storage requests → Storage accounting: reads
src/worker/ipc/storage.js - Storage accounting → Spaces and membership: lists spaces
src/shared/storage/storage.js - User → Spaces and membership: creates or joins
README.md - Spaces and membership → Identity and profile: grants content key
README.md - User → Folder publishing: shares folders
README.md - Folder publishing → Share catalog: writes metadata
src/shared/folders/publish-service.js - User → Content transfers: requests downloads
README.md - Content transfers → Encrypted peer network: fetches peer chunks
README.md - Encrypted peer network → Share catalog: exchanges encrypted metadata
README.md - User → Folder mounts: mirrors folders
README.md - Encrypted peer network → P2P updates: distributes releases
README.md