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

breadhelp 0.2.0: live guided tour overlay replacing static onboarding

Browse source 
Replaces the old in-window onboarding wizard with a real screen-wide
tour: dim + spotlight cutout around the actual on-screen component
(breadbar, breadbox), floating callout teaching the shortcut, and
event-driven confirmation via real Hyprland/breadd signals instead of
click-through fakery.
This commit is contained in:
Breadway 2026-07-15 18:48:10 +08:00
parent 78b2f420a5
commit b2f0b2a500
22 changed files with 1186 additions and 299 deletions
Download patch file Download diff file Expand all files Collapse all files

24
breadhelp/content/tours/onboarding.toml Normal file
View file

@ -0,0 +1,24 @@
# Live guided tour steps, walked by ui::tour. Phase A validation subset —
# just enough to prove the spotlight/must-do engine end-to-end (breadbar's
# plain observe-only highlight, breadbox's real openlayer detection) before
# authoring the full app-by-app tour. See breadhelp-tour.lua for the
# `--tour-event` ids this matches against.
[[step]]
id = "welcome"
title = "Welcome to BOS"
body = "This is a quick, hands-on tour of your desktop. Instead of just describing things, we'll point at the real thing on screen as we go. Press Next when you're ready."
[[step]]
id = "breadbar"
title = "Breadbar"
body = "This bar across the top of your screen always shows your workspace, the time, and quick status for network, volume, and battery. Click any icon on it to see more."
target_namespace = "breadbar"
[[step]]
id = "breadbox"
title = "Opening apps"
body = "Everything in BOS opens from here. Press [Show Keybind]super + space[/Show Keybind] to open breadbox, then start typing an app's name and press Enter to launch it."
target_namespace = "breadbox"
launch = "breadbox"
success_event = "layer-closed:breadbox"