Skip to content

feat(gui): Sync — IBD progress + backfill + troubleshooting #4

@Noyi-24-7

Description

@Noyi-24-7

Summary

Sync screen for Floresta GUI (v0).

Goal: show syncing progress clearly, explain what’s happening, and provide fast troubleshooting links (Peers/Logs).

Parent index: #1


Frame


Sections

A) Sync progress

  • Step (e.g., 2/3)
  • Progress % bar
  • Height → Target height
  • Behind blocks estimate
  • Peers count + optional transport detail (v2/v1)

B) Timeline + “what this means”

  • Timeline (Headers ✅ / Blocks ⏳ / Catch-up ⏸) if available
  • Friendly explanation: “Floresta checks Bitcoin rules as it downloads data.”

C) Backfill (if enabled)

  • Backfill progress % with explanation
  • Optional pause/resume (if supported; otherwise omit)

D) Actions

  • View Peers
  • Open Logs
  • Refresh / Retry (depending on state)

States covered

  • READY: normal progress
  • LOADING: calculating progress / skeleton values (Coming Soon!!)
  • EMPTY: peers=0 → “Waiting for peers. Sync can’t continue.” + Go to Peers (Coming Soon!!)
  • ERROR: sync stopped + Open Logs + Retry (Coming Soon!!)
  • LOCKED: disable actions if not supported / requires settings (Coming Soon!!)

Questions

  1. Should Backfill always live on Sync (and optionally summarized on Overview), or Sync-only?
  2. Any preferred troubleshooting copy for “no peers”?

Acceptance notes (implementation later)

  • Desktop-first
  • Most common failure paths are one click away (Peers, Logs)
  • Copy stays simple and user-friendly

Image

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions