# clash-verge-rev/clash-verge-rev architecture

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

- Interactive diagram: https://gitdiagram.com/clash-verge-rev/clash-verge-rev
- Repository: https://github.com/clash-verge-rev/clash-verge-rev

## Overview

Clash Verge Rev is a Tauri desktop GUI for the Clash Meta (mihomo) proxy core. Users manage profiles and settings, control proxy and TUN operation, and inspect connections, traffic, logs, rules, and media-service availability. The frontend bootstraps routed pages and invokes native commands; the Rust backend manages the core lifecycle, configuration, and service mode. The README documents backup/sync and configuration-enhancement capabilities. Several feature paths are identified from the tree and README, but their internal call relationships were not sampled, so those links are not inferred.

Main entry points: [`src-tauri/src/core/service.rs`](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/core/service.rs) (Core service mode), [`src/pages`](https://github.com/clash-verge-rev/clash-verge-rev/tree/dev/src/pages) (Routed pages), [`src/services/cmds.ts`](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src/services/cmds.ts) (Native command client), [`src-tauri/src/core/manager/mod.rs`](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/core/manager/mod.rs) (Core lifecycle manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_bootstrap["App bootstrap<br/>[main.tsx]"]
  node_pages["Routed pages"]
  node_proxy_ui["Proxy and connection views"]
  node_settings_ui["Settings views"]
  node_notice_ui["Notice display<br/>[notice-manager.tsx]"]
end

subgraph group_frontend["Frontend services"]
  node_query["Query cache<br/>[query-client.ts]"]
  node_clash_hook["Core data hook<br/>[use-clash.ts]"]
  node_commands["Native command client<br/>[cmds.ts]"]
  node_notices["Notice state<br/>[notice-service.ts]"]
end

subgraph group_native["Native runtime"]
  node_native_commands["Native commands"]
  node_core_service["Core service mode<br/>[service.rs]"]
  node_core_manager["Core lifecycle manager<br/>[mod.rs]"]
  node_run_state["Runtime state<br/>[mod.rs]"]
  node_handle["App event handle<br/>[handle.rs]"]
  node_notification["Native notifications<br/>[notification.rs]"]
  node_directories["App directories<br/>[dirs.rs]"]
  node_owner["Owner identity<br/>[owner_identity.rs]"]
end

subgraph group_config["Configuration"]
  node_profiles[("Profile configuration<br/>[profiles.rs]")]
  node_config["Runtime configuration<br/>[config.rs]"]
end

subgraph group_support["Product features"]
  node_enhance["Config enhancement"]
  node_backup["Backup and sync<br/>[backup.rs]"]
  node_media_unlock["Media unlock checks<br/>[mod.rs]"]
end

node_user(("Desktop user"))

node_user -->|"uses"| node_pages
node_bootstrap -->|"mounts router"| node_pages
node_pages -.->|"proxy workflows"| node_proxy_ui
node_pages -.->|"settings workflows"| node_settings_ui
node_clash_hook -->|"calls"| node_commands
node_commands -.->|"invokes commands"| node_native_commands
node_commands -->|"reports failures"| node_notices
node_notice_ui -->|"subscribes"| node_notices
node_core_service -->|"uses"| node_core_manager
node_core_service -->|"uses"| node_config
node_core_service -->|"uses"| node_handle
node_core_service -->|"uses"| node_directories
node_core_manager -->|"uses"| node_run_state
node_core_manager -->|"uses"| node_config
node_handle -->|"dispatches events"| node_notification
node_directories -->|"resolves identity"| node_owner
node_profiles -.->|"manages profiles"| node_user
node_enhance -.->|"enhances configuration"| node_user
node_backup -.->|"backs up configuration"| node_user
node_media_unlock -.->|"checks services"| node_user

click node_bootstrap "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src/main.tsx"
click node_pages "https://github.com/clash-verge-rev/clash-verge-rev/tree/dev/src/pages"
click node_proxy_ui "https://github.com/clash-verge-rev/clash-verge-rev/tree/dev/src/components/proxy"
click node_settings_ui "https://github.com/clash-verge-rev/clash-verge-rev/tree/dev/src/components/setting"
click node_query "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src/services/query-client.ts"
click node_clash_hook "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src/hooks/use-clash.ts"
click node_commands "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src/services/cmds.ts"
click node_notices "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src/services/notice-service.ts"
click node_notice_ui "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src/components/layout/notice-manager.tsx"
click node_native_commands "https://github.com/clash-verge-rev/clash-verge-rev/tree/dev/src-tauri/src/cmd"
click node_core_service "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/core/service.rs"
click node_core_manager "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/core/manager/mod.rs"
click node_run_state "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/core/runstate/mod.rs"
click node_handle "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/core/handle.rs"
click node_notification "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/core/notification.rs"
click node_directories "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/utils/dirs.rs"
click node_owner "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/core/owner_identity.rs"
click node_profiles "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/config/profiles.rs"
click node_config "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/config/config.rs"
click node_enhance "https://github.com/clash-verge-rev/clash-verge-rev/tree/dev/src-tauri/src/enhance"
click node_backup "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/feat/backup.rs"
click node_media_unlock "https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/cmd/media_unlock_checker/mod.rs"

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_bootstrap,node_pages,node_proxy_ui,node_settings_ui,node_notice_ui,node_user toneBlue
class node_query,node_clash_hook,node_commands,node_notices toneAmber
class node_native_commands,node_core_service,node_core_manager,node_run_state,node_handle,node_notification,node_directories,node_owner toneMint
class node_profiles,node_config toneRose
class node_enhance,node_backup,node_media_unlock toneIndigo
```

## Components

### Desktop interface

- [App bootstrap](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src/main.tsx): `src/main.tsx`
- [Routed pages](https://github.com/clash-verge-rev/clash-verge-rev/tree/dev/src/pages): `src/pages`
- [Proxy and connection views](https://github.com/clash-verge-rev/clash-verge-rev/tree/dev/src/components/proxy): `src/components/proxy`
- [Settings views](https://github.com/clash-verge-rev/clash-verge-rev/tree/dev/src/components/setting): `src/components/setting`
- [Notice display](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src/components/layout/notice-manager.tsx): `src/components/layout/notice-manager.tsx`

### Frontend services

- [Query cache](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src/services/query-client.ts): `src/services/query-client.ts`
- [Core data hook](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src/hooks/use-clash.ts): `src/hooks/use-clash.ts`
- [Native command client](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src/services/cmds.ts): `src/services/cmds.ts`
- [Notice state](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src/services/notice-service.ts): `src/services/notice-service.ts`

### Native runtime

- [Native commands](https://github.com/clash-verge-rev/clash-verge-rev/tree/dev/src-tauri/src/cmd): `src-tauri/src/cmd`
- [Core service mode](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/core/service.rs): `src-tauri/src/core/service.rs`
- [Core lifecycle manager](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/core/manager/mod.rs): `src-tauri/src/core/manager/mod.rs`
- [Runtime state](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/core/runstate/mod.rs): `src-tauri/src/core/runstate/mod.rs`
- [App event handle](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/core/handle.rs): `src-tauri/src/core/handle.rs`
- [Native notifications](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/core/notification.rs): `src-tauri/src/core/notification.rs`
- [App directories](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/utils/dirs.rs): `src-tauri/src/utils/dirs.rs`
- [Owner identity](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/core/owner_identity.rs): `src-tauri/src/core/owner_identity.rs`

### Configuration

- [Profile configuration](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/config/profiles.rs): `src-tauri/src/config/profiles.rs`
- [Runtime configuration](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/config/config.rs): `src-tauri/src/config/config.rs`

### Product features

- [Config enhancement](https://github.com/clash-verge-rev/clash-verge-rev/tree/dev/src-tauri/src/enhance): `src-tauri/src/enhance`
- [Backup and sync](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/feat/backup.rs): `src-tauri/src/feat/backup.rs`
- [Media unlock checks](https://github.com/clash-verge-rev/clash-verge-rev/blob/dev/src-tauri/src/cmd/media_unlock_checker/mod.rs): `src-tauri/src/cmd/media_unlock_checker/mod.rs`

### Other components

- **Desktop user**

## Connections

- Desktop user → Routed pages: uses (evidence: `README.md`)
- App bootstrap → Routed pages: mounts router (evidence: `src/main.tsx`)
- Routed pages → Proxy and connection views: proxy workflows
- Routed pages → Settings views: settings workflows
- Core data hook → Native command client: calls (evidence: `src/hooks/use-clash.ts`)
- Native command client → Native commands: invokes commands
- Native command client → Notice state: reports failures (evidence: `src/services/cmds.ts`)
- Notice display → Notice state: subscribes (evidence: `src/components/layout/notice-manager.tsx`)
- Core service mode → Core lifecycle manager: uses (evidence: `src-tauri/src/core/service.rs`)
- Core service mode → Runtime configuration: uses (evidence: `src-tauri/src/core/service.rs`)
- Core service mode → App event handle: uses (evidence: `src-tauri/src/core/service.rs`)
- Core service mode → App directories: uses (evidence: `src-tauri/src/core/service.rs`)
- Core lifecycle manager → Runtime state: uses (evidence: `src-tauri/src/core/manager/mod.rs`)
- Core lifecycle manager → Runtime configuration: uses (evidence: `src-tauri/src/core/manager/mod.rs`)
- App event handle → Native notifications: dispatches events (evidence: `src-tauri/src/core/handle.rs`)
- App directories → Owner identity: resolves identity (evidence: `src-tauri/src/utils/dirs.rs`)
- Profile configuration → Desktop user: manages profiles (evidence: `README.md`)
- Config enhancement → Desktop user: enhances configuration (evidence: `README.md`)
- Backup and sync → Desktop user: backs up configuration (evidence: `README.md`)
- Media unlock checks → Desktop user: checks services
