Extract bos-settings to its own repo; add breadhelp; JSON-driven Hyprland config

bos-settings moves to git.breadway.dev/Breadway/bos-settings (full history
preserved via git-filter-repo) so its release cadence is decoupled from
BOS's own. breadhelp takes its place as this repo's workspace member: a
GTK4 onboarding/help center replacing the old bos-welcome/bos-keybinds
bash scripts with searchable guides, an interactive keybind viewer
(sourced from the new keybinds.toml, not parsed out of hyprland.lua or
hardcoded), a troubleshooting wizard with one-click fixes, and a proper
first-run tour. bos-netcheck extracts bos-welcome's network-check half,
which still needs to run every login independent of breadhelp's own
first-run gating.

hyprland.lua's keybinds/settings/monitors/autostart are now JSON-driven
(binds.json/settings.json/monitors.json/autostart.json) with every
loader pcall-wrapped and falling back to hardcoded defaults per field on
bad or missing config, so bread* apps (bos-settings' new editors, and
breadhelp's keybind viewer) can read/write this config without ever
being able to leave the compositor unable to start.

CI's package.yml now builds breadhelp instead of bos-settings on tag
push; bos-settings needs its own equivalent workflow in its new repo
(not yet set up).
This commit is contained in:
Breadway 2026-07-05 09:16:14 +08:00
parent 434efcea22
commit 664298b6b4
105 changed files with 3280 additions and 5149 deletions

View file

@ -1,18 +1,32 @@
Arch packaging
==============
`PKGBUILD` builds and installs `bos-settings` from source.
`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`,
`github.com/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
```bash
makepkg -si
cd breadhelp && makepkg -si
```
## Before publishing to [breadway] repo
1. Tag a release on GitHub.
2. Update `pkgver` to match the tag.
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:
1. Tag a release on GitHub (`vX.Y.Z`).
2. Update `pkgver` in `breadhelp/PKGBUILD` to match the tag.
3. Update `source` to the release tarball URL.
4. Run `updpkgsums` (or manually set `sha256sums`).
@ -22,4 +36,4 @@ makepkg -si
|---------|----------|-------|
| `gtk4` | yes | UI toolkit |
| `glib2` | yes | always |
| `snapper` | optional | snapshot management view |
| `snapper` | optional | create-backup one-click fix |

View file

@ -1,9 +0,0 @@
[Desktop Entry]
Name=BOS Settings
Comment=System settings for Bread OS
Exec=bos-settings
Icon=preferences-system
Terminal=false
Type=Application
Categories=Settings;System;
StartupWMClass=bos-settings

View file

@ -1,9 +1,9 @@
# Maintainer: Breadway <rileyhorsham@gmail.com>
pkgname=bos-settings
pkgname=breadhelp
pkgver=0.1.0
pkgrel=1
pkgdesc="System settings app for Bread OS"
pkgdesc="Onboarding and help center for Bread OS"
arch=('x86_64')
url="https://github.com/Breadway/bos"
license=('MIT')
@ -13,7 +13,7 @@ license=('MIT')
options=(!lto !debug)
depends=('gtk4' 'glib2' 'hicolor-icon-theme')
optdepends=(
'snapper: snapshot management view'
'snapper: create-backup one-click fix'
)
makedepends=('rust' 'cargo')
source=("${pkgname}-${pkgver}.tar.gz")
@ -21,18 +21,20 @@ sha256sums=('SKIP')
build() {
cd "${srcdir}/${pkgname}-${pkgver}"
cargo build --release --locked -p bos-settings
cargo build --release --locked -p breadhelp
}
check() {
cd "${srcdir}/${pkgname}-${pkgver}"
cargo test --release --locked -p bos-settings
cargo test --release --locked -p breadhelp
}
package() {
cd "${srcdir}/${pkgname}-${pkgver}"
install -Dm755 target/release/bos-settings "${pkgdir}/usr/bin/bos-settings"
install -Dm644 packaging/arch/bos-settings.desktop \
"${pkgdir}/usr/share/applications/bos-settings.desktop"
install -Dm755 target/release/breadhelp "${pkgdir}/usr/bin/breadhelp"
install -Dm644 packaging/arch/breadhelp/breadhelp.desktop \
"${pkgdir}/usr/share/applications/breadhelp.desktop"
install -d "${pkgdir}/usr/share/breadhelp"
cp -r breadhelp/content "${pkgdir}/usr/share/breadhelp/content"
install -Dm644 LICENSE "${pkgdir}/usr/share/licenses/${pkgname}/LICENSE"
}

View file

@ -0,0 +1,9 @@
[Desktop Entry]
Name=BOS Help
Comment=Your personal guide to the Bread desktop
Exec=breadhelp
Icon=help-browser
Terminal=false
Type=Application
Categories=Help;System;
StartupWMClass=com.breadway.breadhelp