This page introduces Clash Verge Rev: what it is, its key features, the platforms it runs on, and its release channels. It is intended as the entry point for new readers. For a step-by-step guide to building or running the project locally, see Installation and Setup. For a technical breakdown of the codebase structure, see Architecture Overview.
Clash Verge Rev is a desktop GUI application for the Mihomo (formerly Clash Meta) proxy core. It is a community-maintained continuation of the original clash-verge project.
The application is built with the Tauri framework, which combines a Rust backend with a React/TypeScript frontend rendered in a native OS webview. The Mihomo binary is bundled as a sidecar process, meaning users do not need to install or manage the proxy core separately.
| Property | Value |
|---|---|
| Current version | 2.4.7 |
| License | GPL-3.0-only |
| Framework | Tauri 2 |
| Backend language | Rust (edition 2024, min version 1.91) |
| Frontend language | TypeScript / React 19 |
| Proxy core | Mihomo (verge-mihomo sidecar) |
| Package manager | pnpm |
Sources: package.json1-5 src-tauri/Cargo.toml1-11 src-tauri/tauri.conf.json1-5
| Platform | Architectures |
|---|---|
| Windows | x64, x86 |
| Linux | x64, arm64 |
| macOS 10.15+ | Intel (x86_64), Apple Silicon (arm64) |
Sources: docs/README_en.md31-33
| Feature | Description |
|---|---|
| Proxy core management | Bundles verge-mihomo and verge-mihomo-alpha sidecars; switchable at runtime |
| Profile management | Supports remote, local, merge, and script profile types with an enhancement pipeline |
| System proxy integration | OS-level proxy settings with guard mode and PAC support |
| TUN mode | Virtual network adapter for full-system traffic routing |
| Visual editors | In-app YAML editors for rules, proxy groups, and proxies using Monaco |
| Theming | MUI-based light/dark/system themes with CSS injection support |
| i18n | English, Chinese, Russian, Farsi, Spanish, Japanese, Korean |
| WebDAV backup | Configuration backup and synchronization |
| Deep linking | Handles clash:// and clash-verge:// URL schemes |
| Auto-update | Built-in updater with multiple endpoint fallbacks |
| System tray | Dynamic tray menu with proxy group switching and speed display |
Sources: docs/README_en.md74-80 src-tauri/tauri.conf.json43-47 src-tauri/Cargo.toml32-107
| Channel | Description | Tag |
|---|---|---|
| Stable | Official releases; high reliability, intended for daily use | versioned tags |
| Alpha | Deprecated; previously used to validate the publish pipeline | alpha |
| AutoBuild | Rolling builds triggered automatically; suitable for testing and feedback | autobuild |
The updater checks multiple endpoints, including a proxy mirror for regions where GitHub may be less accessible:
https://download.clashverge.dev/https://github.com/.../update-proxy.json
https://gh-proxy.com/https://github.com/.../update-proxy.json
https://github.com/.../update.json
Sources: docs/README_en.md36-40 src-tauri/tauri.conf.json34-38
High-level technology map:
Sources: package.json36-80 src-tauri/Cargo.toml32-107
Key directories and files:
Sources: src-tauri/tauri.conf.json1-62 src-tauri/Cargo.toml1-125 package.json17-18
The diagram below maps the named architectural subsystems to the concrete code entities that implement them. This serves as a navigational reference; each subsystem is covered in depth in subsequent wiki pages.
Sources: src-tauri/Cargo.toml32-107 src-tauri/tauri.conf.json16
The rest of this wiki covers each subsystem in depth:
prebuild.mjs script, and running the dev serverupdater.mjs script