Everyday · architecture profile
Liferaft
Offline desktop recovery for large .mbox archives. An Electron desktop application with a React interface and per-archive SQLite indexes.
How it is built.
Liferaft is deliberately offline. It imports one or more .mbox archives, streams them through an Electron utility process, indexes messages in SQLite FTS5 and exports attachments or selected messages. There is no account, sync, compose, send or remote access path.
- Stack
- Electron 41, React 19.2, TypeScript, electron-vite 4, Tailwind 4, SQLite FTS5, better-sqlite3, mailparserEvidence: package.json; README.md
- Runtime
- Electron main process plus a utility process for import; no serverEvidence: src/main/index.ts; README.md
- Storage
- One SQLite database per archive under the app's userData directory, with message byte ranges and attachment offsetsEvidence: src/main/index.ts; README.md
- Identity
- None. No login, sync or remote access path.Evidence: README.md
- Delivery
- Tagged releases build macOS, Windows and Linux artifacts through electron-builder in a GitHub Actions release workflowEvidence: .github/workflows/release.yml; package.json scripts
- Integrations
- None. The product has no network dependency.Evidence: README.md
The shape of the system.
- Main processOwns the window, filesystem access and the per-archive database lifecycle.Evidence: src/main/index.ts
- Import utilityStreams the source file outside the UI process so a large archive does not freeze the window.Evidence: README.md
- IndexSQLite FTS5 stores searchable message metadata and body text.Evidence: README.md
- RendererReact and react-virtuoso present a three-pane recovery view over large result sets.Evidence: package.json; src
Engineering decisions worth knowing.
- Read-only is a security boundary
No compose, send or remote path means a recovered archive cannot be modified or exfiltrated by the app itself. Export is a deliberate user action.
- One database per archive
Separate databases keep an import failure local and let a user delete one archive without rebuilding the rest.
What it connects to.
No verified cross-project runtime relationship. Liferaft is reachable from Woodhouse as a published record, and its product links are ordinary navigable links.
Authoritative public sources
What this review does not know.
- The macOS signing identity is `-` (unsigned) in the reviewed build configuration; notarisation and install trust were not verified.
- Import performance on archives larger than the tested sizes was not measured.
- No recovery drill on a real mailbox was performed.