Building from Source

Building from source

The app is a Wails v2 project in app/: Go backend + React/TypeScript frontend.

Prerequisites

• Go 1.26+
• Node 22+
• Wails CLI v2.12 — go install github.com/wailsapp/wails/v2/cmd/wails@v2.12.0
• Platform build deps:
  • Linux: libgtk-3-dev and libwebkit2gtk-4.1-dev (build with -tags webkit2_41)
  • Windows / macOS: the standard toolchains (WebView2 is bundled on Windows)

Develop

cd app
wails dev        # hot-reload dev build

Build

cd app
wails build                                   # current platform → app/build/bin/
wails build -platform linux/amd64 -tags webkit2_41
wails build -platform darwin/universal

Tests & checks

cd app
go vet ./...
go test ./...           # Graph client + service-layer tests (httptest mock)
cd frontend && npx tsc --noEmit && npm run build

Releases (maintainers)

Tag vX.Y.Z and push it — GitHub Actions builds all platforms, signs the checksums with minisign, publishes the release, refreshes the download site, and updates the AUR package. Full details are in docs/RELEASING.md.