History

Breadway c24202cff1 Some checks failed Mirror to GitHub / mirror (push) Failing after 3s Details Build and publish calamares / calamares (push) Failing after 3m2s Details Build and release ISO / release-iso (push) Successful in 11m52s Details Add touchpad workspace-swipe gestures, pacman/yay aliases, re-enable breadhelp package, fix identity URLs		2026-07-19 03:08:24 +08:00
..
README.md	Add touchpad workspace-swipe gestures, pacman/yay aliases, re-enable breadhelp package, fix identity URLs	2026-07-19 03:08:24 +08:00

README.md

Arch packaging

breadhelp/PKGBUILD builds and installs breadhelp from source — BOS's onboarding + help center, and the only first-party pacman package still built from this repo.

bos-settings is also pacman-packaged and served from the same [breadway] repo, but its source lives in its own repo now (~/Projects/bos-settings, git.breadway.dev/Breadway/bos-settings) so a bos-settings release doesn't require a BOS ISO release.

Everything else the bread ecosystem ships (breadbar, breadbox, breadpad, ...) is bakery-managed, not pacman-packaged — see build-local.sh.

Local build

cd breadhelp && makepkg -si

Before publishing to [breadway] repo

CI (.forgejo/workflows/package.yml) handles this on tag push (vX.Y.Z): it bumps pkgver, archives the repo into the expected tarball name, and runs makepkg. To do it by hand instead:

Tag a release on GitHub (vX.Y.Z).
Update pkgver in breadhelp/PKGBUILD to match the tag.
Update source to the release tarball URL.
Run updpkgsums (or manually set sha256sums).

Runtime dependencies

Package	Required	Notes
`gtk4`	yes	UI toolkit
`glib2`	yes	always
`snapper`	optional	create-backup one-click fix