Everyday · architecture profile

Liferaft

Offline desktop recovery for large .mbox archives. An Electron desktop application with a React interface and per-archive SQLite indexes.

LiveArchitecture reviewed 7 November 2026Dossier reviewed 6 November 2026

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.

  1. Main processOwns the window, filesystem access and the per-archive database lifecycle.Evidence: src/main/index.ts
  2. Import utilityStreams the source file outside the UI process so a large archive does not freeze the window.Evidence: README.md
  3. IndexSQLite FTS5 stores searchable message metadata and body text.Evidence: README.md
  4. 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.