[joshuadav86]

Requested by Joshua · project thread

What changed

The first-run Welcome screen becomes five short steps before the first scan (decision #121):

1. This machine: its name, and whether it's the main one (becomes the Primary Rig / already have a main machine / not sure yet).
2. DAWs: Reaper and/or Ableton Live.
3. How files travel: cloud folder (Dropbox, OneDrive, iCloud…), home network, private GitHub repo, or decide later. Each one gets a line on what it's good at and a line on its limits. The wording lives in the new app/src/SyncMethods.tsx so other screens can reuse it. The cloud folder picker and GitHub sign-in open right in place.
4. What stays the same: Choose what syncs collapsed into six plain groups (templates, scripts and devices, presets/chains/racks, shortcuts/menus/mouse, themes, library layout). Only the groups for the DAWs you picked are shown.
5. Ready: a summary of what will happen, then Scan this machine.

Each answer changes a real setting:

• A cloud folder or GitHub repo is set right away, and Keep files in sync turns on.
• After the scan, a DAW you unticked is no longer watched here and its files stop syncing to this machine.
• "Main" makes the scan the Primary Rig, unless a Primary Rig already exists.
• "My main machine already has Patch Pilot" opens Link your machines on Enter a code.
• Home network turns on (lan_use + keep in sync) as soon as this machine is linked.

The tour no longer opens on a first run, because the questions count as having seen it. How it works still opens it, and machines scanned before this change still see it once. LinkDialog takes a start prop. GitHubSetup takes bare to hide its intro line where the choice above already explains GitHub.

Explainers on Get Up To Speed, Set up, This machine and Settings are left to the sibling "Explain how scripts and templates sync" thread, so the two PRs don't collide.

How it was tested

• npm run build (tsc + vite) passes.
• Rendered every step with mocked Tauri IPC in dark and light (Playwright, script in the project's screenshots/first-run-questions/).
• Windows (not run on a real machine)
• macOS (not run on a real machine)

Checklist

• Follows the non-negotiable rules in CLAUDE.md (nothing loaded, no files copied by the questions themselves)
• Added a line to docs/decisions.md (Back up everything to a cloud folder, and restore it on any machine #121) and the roadmap row in docs/strategy.md
• Updated CLAUDE.md if build steps or conventions changed (none changed)

---

Generated by Claude Code