Onboarding and help center for BOS
Find a file
Breadway 36cb292213
Some checks failed
beta (rc) release / build (push) Has been skipped
dev release / build (push) Successful in 2m28s
release / build (push) Failing after 2m23s
Bump version to v0.2.6
2026-08-16 14:09:43 +08:00
.forgejo/workflows CI: stop wiping shared bread-ecosystem clones mid-job 2026-08-16 13:46:28 +08:00
ci CI: stop wiping shared bread-ecosystem clones mid-job 2026-08-16 13:46:28 +08:00
content Ecosystem platform pass: bakery identity, v0.7.1 pins, BOS keybinds 2026-08-15 21:39:24 +08:00
packaging Ecosystem platform pass: bakery identity, v0.7.1 pins, BOS keybinds 2026-08-15 21:39:24 +08:00
src Bind help windows to the current monitor's bread-theme palette 2026-08-16 13:25:24 +08:00
.gitignore Track AGENTS.md 2026-08-15 22:03:30 +08:00
AGENTS.md Track AGENTS.md 2026-08-15 22:03:30 +08:00
bakery.toml Onboard onto bakery: bakery.toml + dev/beta/release CI, relocate content paths 2026-07-23 10:10:30 +08:00
Cargo.lock Bump version to v0.2.6 2026-08-16 14:09:43 +08:00
Cargo.toml Bump version to v0.2.6 2026-08-16 14:09:43 +08:00
CONTRIBUTING.md CONTRIBUTING.md: document single-trunk + RC-tag release model 2026-07-31 11:08:41 +08:00
EVENTS.md Add a day-zero first-run wizard before the desktop tour 2026-08-16 00:00:23 +08:00
LICENSE Add standalone repo scaffolding (README, packaging, CI) 2026-07-15 19:00:30 +08:00
README.md Add a day-zero first-run wizard before the desktop tour 2026-08-16 00:00:23 +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, a short first-boot day-zero wizard (timezone, network hint, updates, snapper), 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. A bakery product (bakery.toml + bakery CI) and baked into the BOS ISO — not pacman-packaged.

Building

cargo build --release

Packaging / releasing

See CONTRIBUTING.md for the single-trunk + tag model. main publishes a bakery dev build; a vX.Y.Z-rc.N tag publishes beta; a vX.Y.Z tag publishes stable. The leftover packaging/ tree is not a pacman source — bakery is canonical (see packaging/README.md).

bread event integration

Works the same with or without breadd. When the main window is shown, breadhelp publishes bread.help.opened. See EVENTS.md.