# happ-proxy/happ-desktop architecture

> Architecture diagram of the GitHub repository happ-proxy/happ-desktop, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/happ-proxy/happ-desktop
- Repository: https://github.com/happ-proxy/happ-desktop

## Overview

Happ is a proxy-management app: users configure their own proxy servers, choosing supported protocols and routing rules, while the app uses the Xray core. The README documents these capabilities but no implementation files or source excerpts were provided, so paths are unavailable and the graph is limited to documented relationships; it does not imply internal call structure.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Proxy client"]
  node_app["Happ app"]
  node_routing["Routing rules"]
  node_protocols["Proxy protocols"]
end

subgraph group_runtime["Proxy runtime"]
  node_xray["Xray core"]
end

node_user(("User"))
node_servers["User servers"]

node_user -->|"manages connections"| node_app
node_app -->|"configures routing"| node_routing
node_app -->|"supports protocols"| node_protocols
node_app -->|"powered by"| node_xray
node_user -->|"provides servers"| node_servers

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_app,node_routing,node_protocols,node_user,node_servers toneBlue
class node_xray toneAmber
```

## Components

### Proxy client

- **Happ app**
- **Routing rules**
- **Proxy protocols**

### Proxy runtime

- **Xray core**

### Other components

- **User**
- **User servers**

## Connections

- User → Happ app: manages connections (evidence: `README.md`)
- Happ app → Routing rules: configures routing (evidence: `README.md`)
- Happ app → Proxy protocols: supports protocols (evidence: `README.md`)
- Happ app → Xray core: powered by (evidence: `README.md`)
- User → User servers: provides servers (evidence: `README.md`)
