Soma Documentation

Soma is a local-first workspace app for structured notes, private collaboration, and peer sync that improves as peers become reachable.

Practical expectation:

• work already on this device stays usable on weak networks
• attachments already downloaded on this device stay usable
• joins, attachments not yet downloaded on this device, and some remote updates may wait for reachable authorized peers
• relay and discovery services help devices connect; an always-on bot can also help keep shared attachments available, but none of these guarantees instant delivery

Start with the Overview, Getting Started, and Glossary, then dive deeper:

• Platform Components – desktop apps, local daemon, and supporting infrastructure.
• End-to-End Flows – join, blobs (CID fetch), and local AI flows.
• libp2p Primer – key concepts used throughout the codebase.
• Peer Connectivity – how peers discover and dial (mDNS, rendezvous, relays).
• Space Membership – capability-based security model for spaces.
• Blobs & Cache Peers – content-addressed blobs + fetch-by-CID protocol.
• Traits & Abstractions – trait-first convention and how to apply it.
• Getting Started – run soma-daemon, the Soma desktop app, and optional server peers.
• Packaging & Deployment – desktop installers plus relay/rendezvous operations.