Breadway/bos
1
0
Fork 0
Code Issues Pull requests Projects Releases 5 Packages Wiki Activity Actions

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

Browse source 
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
Download patch file Download diff file Expand all files Collapse all files

35
breadhelp/content/troubleshooting/_symptoms/no-sound.toml Normal file
View file

@ -0,0 +1,35 @@
# Symptom tree for the troubleshooting wizard — walked by
# src/ui/troubleshoot_wizard.rs via src/content/troubleshoot.rs.
[[node]]
id = "start"
prompt = "What's wrong with your sound?"
[[node.options]]
label = "No sound at all"
goto = "restart-audio"
[[node.options]]
label = "Wrong output device (e.g. HDMI instead of speakers)"
goto = "wrong-device"
[[node]]
id = "restart-audio"
prompt = "Restarting the audio service fixes this most of the time."
[node.fix]
description = "Restart PipeWire/WirePlumber"
command = "systemctl --user restart wireplumber pipewire pipewire.socket pipewire-pulse pipewire-pulse.socket"
requires_confirm = false
[[node]]
id = "wrong-device"
prompt = "Open Sound settings and pick the right output device from the list."
[[node.options]]
label = "Open Sound settings"
goto = "open-sound-settings"
[[node]]
id = "open-sound-settings"
prompt = "Opening BOS Settings' Sound page."
[node.fix]
description = "Open Sound settings"
command = "bos-settings --page sound"
requires_confirm = false

25
breadhelp/content/troubleshooting/_symptoms/wifi-wont-connect.toml Normal file
View file

@ -0,0 +1,25 @@
[[node]]
id = "start"
prompt = "What's happening with Wi-Fi?"
[[node.options]]
label = "It won't connect / keeps dropping"
goto = "toggle-radio"
[[node.options]]
label = "I need to manage saved networks or profiles"
goto = "breadcrumbs"
[[node]]
id = "toggle-radio"
prompt = "Toggling the Wi-Fi radio off and back on clears up most connection issues."
[node.fix]
description = "Reconnect Wi-Fi"
command = "nmcli radio wifi off && sleep 1 && nmcli radio wifi on"
requires_confirm = false
[[node]]
id = "breadcrumbs"
prompt = "breadcrumbs manages your saved networks and profiles (home, work, away)."
[node.fix]
description = "Open breadcrumbs"
command = "breadcrumbs"
requires_confirm = false