Venom-Verge

macOS desktop client for managing Zhihu iOS componentized development, built with SwiftUI.

Features

Component Management

• Browse and search components from Venomfile + Venomfiles
• Developing mode: add/remove components via customization.yml
• Context menu: Open in Terminal, Fork, Generate Asset Code, Clone & Integrate
• Version badges: tag, branch, local path with color-coded indicators
• Detail panel with repository info and cached metadata

Build

• One-click venom make / make source via bundled venom-cli
• Cancellable builds with real-time colorized console output
• Multi-phase progress bar with accurate component tracking
• Build completion notifications
• Nokogiri build failure auto-detection with fix tips

CI & MRs

• YunXiao CI integration with pipeline status
• Merge request list with approval state
• Notification polling for approval requests

Settings

• Multi-project support with security-scoped folder access
• Custom venom-cli path with version display and one-click update
• Shell path, terminal app selection
• Environment health checks (Ruby, venom-cli)

Requirements

• macOS 13.0+
• Xcode 15.0+
• Git
• Ruby >= 2.7.3 (for bundled venom-cli)

Build

open Venom-Verge.xcodeproj
# Cmd+R in Xcode

Or create a DMG:

./scripts/bump-version.sh
./scripts/create-dmg.sh <version>

See INSTALL.md for detailed instructions.

Project Structure

Venom-Verge/
├── Venom-Verge/
│   ├── Venom_VergeApp.swift       # App entry point
│   ├── VenomProjectService.swift  # Core project resolution & CLI
│   ├── Model/                     # Data models
│   ├── Views/
│   │   ├── Components/            # Component list, rows, detail
│   │   ├── CI/                    # CI pipeline view
│   │   ├── MRs/                   # Merge requests
│   │   ├── Tasks/                 # Task list
│   │   ├── Notifications/         # Approval notifications
│   │   ├── Analytics/             # Build analytics
│   │   └── Common/                # Shared UI (console, sidebar, toast)
│   ├── Service/                   # Build, auth, notification services
│   ├── Tool/                      # ShellTool, parsers
│   └── Theme/                     # Custom theme
├── Resources/
│   └── venom-cli/                 # Bundled venom-cli v1.2.0
└── scripts/                       # Build & version scripts

Bundled venom-cli

Venom-Verge ships with venom-cli v1.2.0, which supports:

| Command | Description | |---------|-------------| | make | Generate Podfile and install dependencies (with colorized output) | | components | List Venom components/dependencies | | switch POD | Switch a pod's source in customization.yml | | gen_asset_code | Generate asset access code for a component | | status | Show git status for locally developed pods | | doctor | Check Venom environment state |

The CLI is located at Resources/venom-cli/ and copied into the app bundle at build time.