How etragardh/cutout works
Cutout is a self-hosted encrypted messenger: the PWA lets people manage servers, contacts, groups, and conversations; the client engine handles identity and messaging flows, while the server acts as an encrypted mailbox. The graph includes the documented protocol, trust, audit, and storage capabilities. Several UI screens and protocol modules were not sampled, so those branches are shown at subsystem level; edges are limited to indexed references or explicit README statements.
Main entry points: engine.ts Messaging engine · main.go Server runtime · EngineProvider.tsx Engine provider · connection.ts Server connection
Components 29
PWA client
- PWA screens
apps/pwa/src/screens - UI components
apps/pwa/src/components - Engine provider
apps/pwa/src/engine/EngineProvider.tsx - Browser storage
apps/pwa/src/platform/browser.ts - ML-DSA WASM
apps/pwa/src/platform/mldsaWasm.ts
Client engine
- Messaging engine
packages/app-core/src/engine/engine.ts - Server connection
packages/app-core/src/engine/connection.ts - Mailbox API client
packages/app-core/src/engine/serverApi.ts - Cover scheduler
packages/app-core/src/engine/cover.ts - Inbound processing
packages/app-core/src/engine/inbound.ts - Message outbox
packages/app-core/src/engine/outbox.ts - Message streams
packages/app-core/src/engine/streams.ts - Identity and group flows
packages/app-core/src/flows - Trust graph
packages/app-core/src/trust.ts - Identity audit log
packages/app-core/src/auditlog.ts - Client repository
packages/app-core/src/store/repo.ts - Local domain model
packages/app-core/src/model.ts
Wire protocol
- Wire protocol suite
packages/protocol/src - Deterministic CBOR
packages/protocol/src/cbor.ts
Mailbox server
- Server runtime
server/cmd/cutout/main.go - Mailbox HTTP API
server/internal/api/api.go - Mailbox authentication
server/internal/auth/auth.go - Rate limiting
server/internal/ratelimit/ratelimit.go - Mailbox store
server/internal/store/store.go - Server protocol codec
server/internal/protocol/encode.go - TLS modes
server/internal/tlsmode/tlsmode.go
Other components
- Messenger user
- Server operator
- Other messenger
Connections 35
- Messenger user → PWA screens: uses
README.md - PWA screens → Engine provider: drives
- Engine provider → Browser storage: opens storage
apps/pwa/src/engine/EngineProvider.tsx - Engine provider → Messaging engine: constructs and starts
apps/pwa/src/engine/EngineProvider.tsx - Engine provider → ML-DSA WASM: loads
apps/pwa/src/engine/EngineProvider.tsx - Engine provider → Client repository: uses
apps/pwa/src/engine/EngineProvider.tsx - PWA screens → UI components: renders
apps/pwa/src/screens/Contacts.tsx - Messaging engine → Client repository: persists via
packages/app-core/src/engine/engine.ts - Messaging engine → Identity audit log: records identity history
packages/app-core/src/engine/engine.ts - Messaging engine → Trust graph: derives trust
packages/app-core/src/engine/engine.ts - Messaging engine → Identity and group flows: uses identity and group flows
packages/app-core/src/engine/engine.ts - Messaging engine → Server connection: uses
packages/app-core/src/engine/engine.ts - Messaging engine → Inbound processing: uses
packages/app-core/src/engine/engine.ts - Messaging engine → Message outbox: uses
packages/app-core/src/engine/engine.ts - Messaging engine → Message streams: uses
packages/app-core/src/engine/engine.ts - Messaging engine → Local domain model: models
packages/app-core/src/engine/engine.ts - Server connection → Mailbox API client: uses
packages/app-core/src/engine/connection.ts - Server connection → Cover scheduler: uses
packages/app-core/src/engine/connection.ts - Server connection → Message outbox: dispatches
packages/app-core/src/engine/connection.ts - Server connection → Message streams: uses
packages/app-core/src/engine/connection.ts - Inbound processing → Message streams: uses
packages/app-core/src/engine/inbound.ts - Identity audit log → Client repository: stores entries
packages/app-core/src/auditlog.ts - Client repository → Local domain model: encodes records
packages/app-core/src/store/repo.ts - Messaging engine → Wire protocol suite: uses wire protocol
packages/app-core/src/engine/engine.ts - Wire protocol suite → Deterministic CBOR: encodes values
packages/protocol/src/qr.ts - Other messenger → Server runtime: sends mailbox traffic
- Server operator → Server runtime: runs
server/cmd/cutout/main.go - Server runtime → Mailbox HTTP API: serves
server/cmd/cutout/main.go - Server runtime → Mailbox store: opens and cleans
server/cmd/cutout/main.go - Server runtime → TLS modes: configures
server/cmd/cutout/main.go - Mailbox HTTP API → Mailbox authentication: uses
server/internal/api/api.go - Mailbox HTTP API → Rate limiting: uses
server/internal/api/api.go - Mailbox HTTP API → Mailbox store: uses
server/internal/api/api.go - Mailbox API client → Mailbox HTTP API: exchanges encrypted mailbox traffic
- Server runtime → Server protocol codec: supports wire encoding