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

[Noyi-24-7]

Summary

This issue covers the first-run Setup Wizard for Floresta GUI (v0).
Goal: help users pick network + storage + startup mode + services, using simple language.

Parent hub: #753

---

Figma 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

---

Flow (step-by-step)

Step 1 — Network (Frame 01)

Purpose: choose which chain Floresta connects to.

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

---

Step 2 — Storage (Frame 02)

Purpose: choose where Floresta stores its files.

• Data folder path input + Browse
• Toggle: Pruned mode (recommended)
• Helper copy: “Pruned = verifies everything, stores less history.”
  Actions: Back / Next

Important state: show folder permission errors clearly:

• Example ERROR: “Folder not writable.”

---

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

Purpose: optionally start faster and validate more in the background.

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

---

Step 4 — Services (Frame 04)

Purpose: pick which “doors” Floresta opens for wallets/apps.

• Electrum Server: ON/OFF (default ON)
  • Port + bind (e.g., 50001, 127.0.0.1)
• Watch-only Wallet Index: ON/OFF (default ON)
• JSON-RPC: ON/OFF (Advanced; default OFF)
  • Port + bind (e.g., 8332, 127.0.0.1)
• Metrics (Prometheus): ON/OFF (default OFF)
  • Port + bind (e.g., 9100, 127.0.0.1)
    Actions: Back / Next

---

Step 5 — Review (Frame 05)

Purpose: confirm choices before starting.

• Summary: Network • Storage path • Pruned • Fast start/backfill • Services enabled
  Actions: Back / “Finish & Start” → routes user to Overview

---

Questions for maintainers

What do you guys think so far? And does this all make sense?

---

Acceptance notes (for later implementation)

• Desktop-first.
• Wizard steps are clickable (Back/Next) and “Finish & Start” lands on Overview.

---

[siwatanejo]

Curious, in last screenshot I see "Mode: Pruned", but there's no screenshot about mode selection, what other modes are there?

[Noyi-24-7]

Curious, in last screenshot I see "Mode: Pruned", but there's no screenshot about mode selection, what other modes are there?

So the way Floresta works as of now to my understanding is in Pruned Mode, and if you look at the 2nd image it shows the fact that the Pruned Mode is by default selected and always on, I just wanted to reiterate on the fact that it's the mode you're on...

Do you have any thoughts on how you'd have preferred to be given that information? I think it wasn't clear before yes?

Also I'm currently working on the rest of the designs on my own repo, it would be migrated here later, it's so the developers don't get so confused while working on other things. I'd love to get your thoughts on other things as they are so here's the full list of stuff - Noyi-24-7/floresta-gui#1

Thanksss 🙏

[siwatanejo]

If Floresta can only work as Pruned at the moment, then I would remove the word "Mode" from the wizard, because otherwise it may make the user think that it can be configured as not-pruned. Instead, I would change the heading "Floresta" to something like "Floresta: your self-sovereign pruned node".

[moisesPompilio]

This looks good, but I have some suggestions. It should be possible to configure the Electrum server, RPC, and wallet settings, because the Electrum server won't always be on that port and may also use TLS. The same goes for the RPC, and in the future we plan to add RPC login. I think it would be very good for the wallet section to have the option to already add the descriptor, addresses, and XPUBs.