Building from Source

Building from Source

The top-level Makefile in the main repo dispatches to each app's native toolchain. On your host OS, make build and make pack pick the right platform automatically.

make help         # list every target
make build        # build for the host platform
make pack         # package a shippable artifact for the host platform
make clean        # remove build artifacts across all platforms

Per-platform targets

make build-gnome    make pack-gnome      make install-gnome
make build-kde      make install-kde
make build-cinnamon make install-cinnamon
make build-xfce     make install-xfce
make build-mate     make install-mate
make build-budgie   make install-budgie
make build-lxqt     make install-lxqt
make build-helper   make install-helper
make build-macos    make pack-macos
make build-windows  make pack-windows

Toolchain requirements

Each platform uses its native toolchain. The minimum versions are:

Platform	Toolchain
macOS	Swift 5.9+, Xcode 15+
Windows	.NET 8 SDK
Linux / GNOME	Node.js 20+, TypeScript, esbuild
Linux / KDE	kf6, kpackagetool6
Linux / Cinnamon	cjs, libsecret, libsoup
Linux / XFCE	meson, ninja, libxfce4panel
Linux / MATE	python3, PyGObject, mate-panel
Linux / Budgie	Vala, libpeas, budgie-desktop
Linux / LXQt	Qt5 (LXQt 1.x) or Qt6 (LXQt 2.x), liblxqt, cmake
Linux / helper	Rust (stable)

Continuous Integration

The cross-platform release binaries for public tags are built by .github/workflows/release.yml on GitHub-hosted runners. Per-commit builds for every platform run via .github/workflows/ci.yml on every push to main and every pull request.

Every release artifact is accompanied by a claudebar-<version>-SHA256SUMS file so you can verify the download locally with sha256sum --check.