Building from Source

Build the Harbor desktop app or CLI from source.

Prerequisites

• Rust (stable, 1.80+)
• Node.js 20+
• Tauri Prerequisites (for the desktop app)

Clone the Repository

git clone https://github.com/JoshuaShunk/Harbor.git
cd Harbor

Desktop App

1. Install frontend dependencies

   cd ui && npm ci && npm run build && cd ..
   
2. Run in development

   cd crates/harbor-desktop && cargo tauri dev
   
3. Build for production

   cd crates/harbor-desktop && cargo tauri build
   

CLI Only

cargo build --release -p harbor-cli

The binary will be at target/release/harbor.

Or install it directly:

cargo install --path crates/harbor-cli

Project Structure

Harbor/
├── crates/
│   ├── harbor-core       # Core library (config, connectors, gateway, vault)
│   ├── harbor-cli        # CLI binary
│   └── harbor-desktop    # Tauri desktop app
└── ui/                   # React frontend
    └── src/
        ├── pages/        # Servers, Hosts, Marketplace, Settings
        ├── components/   # Shared components
        └── contexts/     # Theme, updates

Tech Stack

Layer	Technology
Core	Rust, Tokio, Axum
Desktop	Tauri v2
Frontend	React 19, TypeScript, Tailwind CSS
Build	Cargo (Rust), Vite (JavaScript)