Onboarding and help center for BOS
Find a file
Breadway df7f51281a Make config writes atomic with backup-before-overwrite
Same discipline as the matching bos-settings fix: state.toml writes went
straight to the target path with no backup and no atomicity, so a crash,
power loss, or disk-full error mid-write could leave the file truncated
or corrupted with no way back.

config::atomic_write now writes to a temp file in the same directory,
renames it over the target (atomic within one filesystem), and backs up
whatever was there before to <path>.bak first. save_doc() goes through it.
Added tests covering the backup/no-leftover-tmp-file behavior and a
save_doc -> load_doc round trip.
2026-07-17 03:28:34 +08:00
.forgejo/workflows CI: install gtk4-layer-shell before makepkg dependency check 2026-07-15 19:08:21 +08:00
content breadhelp 0.2.0: live guided tour overlay replacing static onboarding 2026-07-15 18:48:10 +08:00
packaging Drop GitHub mirror workflow for now (Forgejo-only remote) 2026-07-15 19:04:31 +08:00
src Make config writes atomic with backup-before-overwrite 2026-07-17 03:28:34 +08:00
.gitignore Ignore local makepkg build artifacts 2026-07-15 19:18:25 +08:00
Cargo.lock breadhelp: bump version to 0.2.1 2026-07-16 18:25:01 +08:00
Cargo.toml breadhelp: bump version to 0.2.1 2026-07-16 18:25:01 +08:00
LICENSE Add standalone repo scaffolding (README, packaging, CI) 2026-07-15 19:00:30 +08:00
README.md CI: install gtk4-layer-shell before makepkg dependency check 2026-07-15 19:08:21 +08:00

breadhelp

Onboarding and help center for BOS (Bread Operating System) — GTK4, a searchable guide library, an interactive keybind viewer, a troubleshooting wizard with one-click fixes, and a live guided tour overlay that spotlights real on-screen bread* apps (breadbar, breadbox, ...) instead of walking through a static wizard.

Split out of the bos repo into its own repo so a breadhelp release doesn't require a BOS ISO release, and vice versa. Pacman-packaged (not bakery-managed) — see packaging/README.md.

Building

cargo build --release

Packaging / releasing

See packaging/README.md. In short: bump Cargo.toml's version, tag vX.Y.Z, push the tag to forgejo.forgejo/workflows/package.yml builds and publishes to the [breadway] pacman repo automatically.