[longzhi]

Phase 2c of the korekore UI (ADR-0021): onboarding, the confirmations and the notifications, on the Mac and on Linux. Behind VIBEBUDDY_UI=korekore; without it both apps behave exactly as before. With this, Phase 2 is complete.

Stacked on #176 (2b) → #175 (2a) → #173 (Phase 1). This PR's own change is the last commit.

What it does

• Onboarding (canvas: "Mac · Onboarding welcome", "Onboarding · find the box, connect, pick, Wi-Fi", end of onboarding on the alerts board): Welcome → Find the box → Connect agents → Pick a character → Wi-Fi → Launch at login → All set, with the step chips along the bottom (done mint, current ink; done ones take you back). Linux has five steps, as today: its install script already connects the agents and sets up the start at login.
• Confirmations (canvas: "CONFIRMATIONS"): the Mac's five NSAlerts become korekore sheets, run modally the same way (KorekoreAlert): the old daemon, the language restart (with its checkbox), flash from file (the two versions as pixel facts), the firmware update, other firmware (in kore-pink, since it erases). Linux already shows these as inline panels (2b).
• Notifications (canvas: "SYSTEM NOTIFICATIONS"): with the switch on, the four use the board's words. Only the words: a notification's look is the system's, its icon the app's.

What each step does is the current onboarding's, copied (OnboardingView, App::guide). Three small behaviours the design implies, all only with the switch on:

• Find the box makes the box blink once by itself when it shows up, so the page can ask "Is this your box blinking?" (with Blink again).
• Connect agents ticks every agent found and not yet connected; "Connect 3" then shows each change before writing it, one after the other.
• What does it send? on the welcome page opens the privacy note in place.

Screenshots

Mac, the real window drawn off screen in a debug build with sample data; the onboarding is drawn with nothing sent to the box (no blink, no Wi-Fi scan).

The sheets:

Linux, drawn headless by iced_test:

Where it departs from the canvas

• Kore's card in Pick a character says COMING SOON (ADR-0021), as on the Character page.
• The box drawing's shell is line (#F1E7D6); the canvas's #EDE3D1 isn't a token. The selected Wi-Fi row is cream instead of #FFF1C2, and the signal bars' off colour backdrop instead of #D8D0E4.
• No security tag (WPA2 / OPEN) on the Wi-Fi rows: the box's scan reports names and signal only, so they show the signal in dBm.
• The welcome headline may shrink a little (to 0.8) to keep its three lines in the window.
• Linux: the link and daemon notifications come from the daemon, which doesn't know which UI is on, so only the firmware notification is reworded there.

Changes to existing files

File	Lines	What
app/Sources/VibeBuddy/AppDelegate.swift	+25 −7	with the switch: the korekore onboarding window, and the old-daemon question as a korekore sheet (both paths share the take-over)
app/Sources/VibeBuddy/AppModel.swift	+15 −4	with the switch: the notifications' korekore words
desktop/src/main.rs	+5 −1	with the switch: view() hands the guide over; the firmware notification's words
app/Localization/zh-Hans.lproj/Localizable.strings	+62	the new strings

Also changed, from 2a/2b: KorekoreSettingsWindow takes a size and button inset (for the onboarding window); the Device and General pages use the korekore sheets; the Linux box-finding cards moved into kk_finding so the guide shares them.

New files: KorekoreUI/Onboarding.swift (frame, step chips, big buttons, KorekoreAlert), VibeBuddy/Korekore/KorekoreOnboarding.swift, VibeBuddy/Korekore/KorekoreFlash.swift, desktop/src/korekore/guide.rs, and the screenshots.

Tests

• just test (cargo test --workspace, SelfTest): pass.
• cargo check and cargo clippy for x86_64-unknown-linux-gnu and the host: pass, no warnings.
• python3 tools/check-localization.py: ok, 478 keys.
• Swift built with -warn-long-expression-type-checking=150: no slow expressions in the new code.
• Not run here: the apps themselves with the switch on, beside the installed app (a sheet's modal loop and the real onboarding with a box plugged in are not covered by the snapshots), and Linux on a real Omarchy desktop.

🤖 Generated with Claude Code

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota.

An organization owner can choose the repository organization as the billing source for reviews requested by members with a paid Copilot license. Learn about Copilot code review billing.