Design

Binding technical constraints and specifications. These documents define what implementations must satisfy.

Foundational Constraints

• Data Model — how reality is represented as structured data
• Testing Philosophy — what correctness means
• Asset Rules — constraints on content and media

Interface Constraints

• UI Invariants — consent, control, and visibility requirements
• Transparency Hooks — structural observability requirements

Security Constraints

• Secure Communication Constraints — privacy, encryption, and truthful claims
• Voting Integrity Constraints — one human, one vote, verifiable
• Use of Force Constraints — limits on coercive authority

Network Architecture

The full network specification lives in the repository under design/network/:

• Object format and encoding (CBOR, BLAKE3, Ed25519)
• Membership, roles, and moderation schemas
• Encryption and key management
• Offline-first synchronization
• Hybrid transport with relay fallback
• Social Graph — follow/friend system, mutual relationships
• Voice/Video/Streaming — WebRTC calls, peer-assisted streaming
• File Sharing — content-addressed P2P file transfer
• Server Federation — trust tiers, discovery, cross-server messaging
• Realtime Relay Protocol — WebSocket relay spec

→ View on GitHub

Architecture Decisions

Key decisions are recorded as Architecture Decision Records:

→ View ADRs on GitHub

Design defines what must be true. Implementations make it real.