feat(gui): Setup wizard — Network/Storage/Fast Start/Services/Review

[Noyi-24-7]

Summary

First-run Setup Wizard for Floresta GUI (v0).

Goal: help users choose network + storage + startup mode + services with friendly copy, and prevent common mistakes (permissions, ports, etc).

Parent index: #1

---

Frames

• Frame 01 — Setup (Network): FIGMA_LINK_FRAME_01
• Frame 02 — Setup (Storage): FIGMA_LINK_FRAME_02
• Frame 03 — Setup (Fast Start): FIGMA_LINK_FRAME_03
• Frame 04 — Setup (Services): FIGMA_LINK_FRAME_04
• Frame 05 — Setup (Review): FIGMA_LINK_FRAME_05

(Links will be filled from design/figma-links.md.)

---

Flow (step-by-step)

Step 1 — Network (Frame 01)

• Options: Mainnet / Testnet4 / Signet / Regtest
• Helper: “Mainnet is real Bitcoin. Test networks are for testing.”
• Action: Next

Step 2 — Storage (Frame 02)

• Data folder input + Browse
• Pruned toggle (recommended)
• Helper: “Pruned = verifies everything, stores less history.”
• Action: Back / Next
• Error example: “Folder not writable.”

Step 3 — Fast Start (Frame 03) (Advanced)

• Fast start (Assume Utreexo) toggle (default: OFF)
• Backfill in background toggle (default: ON)
• Helper: “Starts quicker, then validates older blocks in the background.”
• Action: Back / Next

Step 4 — Services (Frame 04)

• Electrum Server toggle (default: ON) + port/bind
• Watch-only Wallet Index toggle (default: ON)
• JSON-RPC toggle (Advanced; default: OFF) + port/bind
• Metrics (Prometheus) toggle (default: OFF) + port/bind
• Action: Back / Next

Step 5 — Review (Frame 05)

• Summary of choices
• Action: Back / Finish & Start → routes to Overview

---

States covered

• READY: normal wizard flow
• LOADING: checking folder permissions / validating ports (Coming Soon!)
• EMPTY: first-run defaults preselected (Coming Soon!)
• ERROR: folder not writable / port in use / invalid path (Coming Soon!)
• LOCKED: advanced toggles hidden/disabled until user expands Advanced (Coming Soon!)

---

Questions

1. Are these labels preferred: “Fast start (Assume Utreexo)” and “Backfill in background”?
2. Should Metrics (Prometheus) be in Setup v0, or Settings-only initially?
3. Should RPC remain off-by-default always?

---

Acceptance notes (implementation later)

• Desktop-first
• Clear error messaging for storage/ports
• Finish routes to Overview

---