# 0xyusufz/live-presence architecture

> Architecture diagram of the GitHub repository 0xyusufz/live-presence, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/0xyusufz/live-presence
- Repository: https://github.com/0xyusufz/live-presence

## Overview

Live Presence is a configuration-only foundation for consent-based screen and camera sharing, not a functioning application yet. The intended workflow is that a desktop publisher shares WebRTC media with an approved browser viewer, while a backend provides signaling. The repository also defines shared protocol/validation and deployment boundaries; authentication, media capture, signaling, TURN, and persistence are not implemented. The README documents the intended relationships, but no runtime source was sampled to verify their implementation.

Main entry points: [`server`](https://github.com/0xyusufz/live-presence/tree/main/server) (Signaling backend), [`apps/desktop`](https://github.com/0xyusufz/live-presence/tree/main/apps/desktop) (Desktop publisher), [`apps/viewer`](https://github.com/0xyusufz/live-presence/tree/main/apps/viewer) (Browser viewer), [`infra`](https://github.com/0xyusufz/live-presence/tree/main/infra) (Deployment config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Sharing clients"]
  node_publisher["Desktop publisher"]
  node_viewer["Browser viewer"]
end

subgraph group_backend["Signaling backend"]
  node_signaling["Signaling backend"]
end

subgraph group_platform["Shared and deployment"]
  node_protocol["Shared protocol"]
  node_deployment["Deployment config"]
end

node_publisher -.->|"publishes WebRTC media"| node_viewer
node_publisher -.->|"uses signaling"| node_signaling
node_signaling -.->|"supports session signaling"| node_viewer
node_deployment -.->|"deploys backend"| node_signaling

click node_publisher "https://github.com/0xyusufz/live-presence/tree/main/apps/desktop"
click node_viewer "https://github.com/0xyusufz/live-presence/tree/main/apps/viewer"
click node_signaling "https://github.com/0xyusufz/live-presence/tree/main/server"
click node_protocol "https://github.com/0xyusufz/live-presence/tree/main/shared"
click node_deployment "https://github.com/0xyusufz/live-presence/tree/main/infra"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_publisher,node_viewer toneBlue
class node_signaling toneAmber
class node_protocol,node_deployment toneMint
```

## Components

### Sharing clients

- [Desktop publisher](https://github.com/0xyusufz/live-presence/tree/main/apps/desktop): `apps/desktop`
- [Browser viewer](https://github.com/0xyusufz/live-presence/tree/main/apps/viewer): `apps/viewer`

### Signaling backend

- [Signaling backend](https://github.com/0xyusufz/live-presence/tree/main/server): `server`

### Shared and deployment

- [Shared protocol](https://github.com/0xyusufz/live-presence/tree/main/shared): `shared`
- [Deployment config](https://github.com/0xyusufz/live-presence/tree/main/infra): `infra`

## Connections

- Desktop publisher → Browser viewer: publishes WebRTC media (evidence: `README.md`)
- Desktop publisher → Signaling backend: uses signaling (evidence: `README.md`)
- Signaling backend → Browser viewer: supports session signaling (evidence: `README.md`)
- Deployment config → Signaling backend: deploys backend (evidence: `README.md`)
