Development

This page covers source builds, tests, packaging, and Flatpak workflows for contributors.

Prerequisites

• Rust 1.70+ (or install via rustup)
• just (https://github.com/casey/just) for task automation
• nfpm (https://nfpm.goreleaser.com) for packaging
• flatpak-builder (https://github.com/flatpak/flatpak-builder) for flatpak

Debian/Ubuntu

sudo apt install build-essential libopencv-dev libclang-dev libv4l-dev \
  libpam0g-dev libgtk-4-dev libadwaita-1-dev

Fedora/RHEL

sudo dnf install @development-tools opencv-devel clang-devel libv4l-devel \
  pam-devel gtk4-devel libadwaita-devel

Arch Linux / Manjaro

sudo pacman -S base-devel opencv clang libv4l pam gtk4 libadwaita

Setup

git clone https://github.com/gundulabs/gaze
cd gaze
just --list

Build and test rust components

just build-rust
just test
just lint
just fmt-check

Packaging

just package <deb | rpm | archlinux>

Package output:

• dist/packages/

Flatpak build

just build-flatpak

Output bundle:

• dist/packages/com.gundulabs.Gaze.flatpak

Cleaning build artifacts

just clean