fix: improve home pull-to-refresh

[pwltr]

Fixes #519
Closes #344

Description

• Replaces the native Home refresh indicator with a stable custom indicator and reserved spacing, avoiding the layout jump when refresh completes.
• Keeps wallet and activity synchronization on the existing refresh lifecycle.
• Refreshes exchange rates on every eligible Home pull and keeps visible refresh feedback active until all requested work finishes, including when the wallet node is unavailable.
• Adds a shared Home scroll identifier and an iOS journey for deterministic rate-refresh verification.

Out of Scope

• Savings and Spending wallet detail-screen pull-to-refresh behavior.
• An explicit widget refresh call; Re-fetch currency rates on pull-to-refresh #344 covers exchange-rate refresh on iOS Home.

Design

N/A — no design available.

Preview

Empty:

Simulator.Screen.Recording.-.iPhone.17.-.2026-09-24.at.21.55.15.mov

Populated:

Simulator.Screen.Recording.-.iPhone.17.-.2026-09-24.at.21.54.43.mov

QA Notes

Journeys

• new pull-to-refresh-rates.xml — Home pull visibly refreshes exchange rates and records a successful update

Manual Tests

N/A

Automated Checks

• ran simulator frame-difference analysis — refresh completion has no isolated layout jump

[greptile-apps]

Confidence Score: 4/5

The PR should not merge until the refresh-completion layout movement is addressed.

Findings

1.  Refresh completion moves wallet content ▶
2.  Rates-only pulls lack feedback ▶
3.  Duplicate assertion depends on timing ▶

Summary

The PR replaces Home’s native pull-to-refresh control with a custom gesture observer and spinner, adds an independent exchange-rate refresh, and provides a log-based QA journey.

• The conditional wallet padding still moves content when refresh completes.
• Rates-only pulls have no visible refresh feedback, and the journey’s duplicate-fetch assertion is timing-dependent.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  A[Home pull ends] --> B{Wallet page?}
  B -- No --> Z[Ignore]
  B -- Yes --> C[Start rate-refresh task]
  C --> D{Wallet node running?}
  D -- No --> E[Return without spinner]
  D -- Yes --> F{Home refresh already active?}
  F -- Yes --> G[Skip wallet and activity sync]
  F -- No --> H[Show spinner and add wallet padding]
  H --> I[Sync wallet, then activity]
  I --> J[Hide spinner and remove padding]

Loading

_{Reviews (1) · Last reviewed commit: "fix: improve pull-to-refresh feedback"}