From 3b872b00425950924bf97526ac3dfdd19f8195eb Mon Sep 17 00:00:00 2001 From: Christopher Date: Thu, 22 Jan 2026 03:36:12 -0800 Subject: [PATCH] Add Architecture & Concepts section to README --- README.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/README.md b/README.md index bfbaa63..a16e946 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,22 @@ Synapsis is an open-source, federated social network built to serve as global co - **Setup Wizard**: User-friendly `/install` flow to get your node running in minutes. - **Curated Feeds**: Smart feed algorithms to highlight engaging content. +## Architecture & Concepts + +Synapsis differs from traditional social networks by prioritizing **sovereign identity** and **federated interoperability**. + +### 🔐 The ID System +Unlike centralized platforms where your identity is a row in a database owned by a corporation, Synapsis uses a cryptographic identity system: +- **DIDs (Decentralized Identifiers)**: Every user is assigned a unique DID (`did:key:...`) upon registration. This is your true, portable identity that exists independently of any specific server. +- **Handles**: Human-readable names (e.g., `@alice`) are mapped to DIDs. This allows you to potentially move your account to a different node while keeping your connections, as the underlying DID remains the same. +- **Cryptographic Signing**: Every post and action is cryptographically signed using your private key, ensuring authenticity and preventing tampering. + +### 🌐 Federation +Synapsis is designed as a network of independent **Nodes**. +- **Sovereign Data**: Communities can run their own Synapsis node, setting their own moderation rules and data policies. +- **Interconnectivity**: Nodes can talk to each other (via ActivityPub), allowing a user on *Node A* to follow and interact with a user on *Node B*. +- **Shared Protocol**: By adhering to open standards (WebFinger, NodeInfo), Synapsis plays nicely with the broader Fediverse. + ## Tech Stack - **Framework**: [Next.js 15+](https://nextjs.org/) (App Router)