Installation

Desktop App (recommended)

Homebrew

The easiest way to install and keep roots up to date:

brew tap konradmichalik/tap
brew install --cask roots

Update with brew upgrade --cask roots.

TIP

Homebrew automatically removes the macOS quarantine attribute — no extra steps needed.

Manual Download

1. Download the latest version from GitHub Releases
2. Open the .dmg file and drag roots into your Applications folder
3. Remove the quarantine attribute so macOS allows the unsigned app:

   xattr -cr /Applications/Roots.app

TIP

The desktop app connects directly to service APIs — no CORS proxy required.

From Source

Prerequisites

• Node.js 18+
• Rust Toolchain (for Tauri builds)

Setup

git clone https://github.com/konradmichalik/roots.git
cd roots
npm install

Desktop Mode (Tauri)

npm run tauri:dev

Browser Mode

Browser mode requires the bundled CORS proxy:

# Terminal 1: Start the proxy
cd proxy && npm install && node server.js

# Terminal 2: Start the dev server
npm run dev

The proxy runs on localhost:3002 and forwards API requests to the respective services.

WARNING

The CORS proxy is intended for local development only. Use the desktop app in production.

Production Build

# Web build
npm run build

# Native desktop build
npm run tauri:build