Development Guide
December 8, 2025 · View on GitHub
Prerequisites
- Go 1.22+
- Node.js 18+
- Wails CLI v2
# Install Wails CLI
go install github.com/wailsapp/wails/v2/cmd/wails@latest
# Check environment dependencies
wails doctor
Development Mode
# Install frontend dependencies
cd frontend && npm install && cd ..
# Start development mode (with hot reload)
wails dev
Build for Release
npm run build # Current platform
npm run build:prod # Production optimized
npm run build:windows # Windows
npm run build:macos # macOS
npm run build:linux # Linux
Build output is in build/bin/ directory.
Project Structure
ccNexus/
├── main.go # Application entry
├── app.go # Core application logic
├── internal/
│ ├── proxy/ # HTTP proxy core
│ ├── transformer/ # API format transformers
│ ├── storage/ # SQLite data storage
│ ├── config/ # Configuration management
│ ├── webdav/ # WebDAV sync
│ ├── logger/ # Logging system
│ └── tray/ # System tray
└── frontend/ # Frontend code
├── src/modules/ # Feature modules
├── src/i18n/ # Internationalization
└── src/themes/ # Theme styles