A gesture-driven refresh control with a slim top status bar that shows “Release to refresh”, then switches to loading and finishes with a Completed ✔ message. It’s safe-area aware, haptic, and fully themeable—perfect for feeds that need clear, unobtrusive refresh feedback.

Functionality

• Natural pull-down gesture with configurable threshold & resistance

• Top status banner with states: pull, release, loading, success/error

• Inline indicator (spinner/Lottie/icon) + animated progress mapping

• Success checkmark / error icon with auto-dismiss delay

• Optional Last updated label and subtle enter/exit transitions

• Programmatic API: refresh(), complete(), fail(), reset()

• Debounce/throttle, timeout, and single-flight guard to prevent duplicates

• Works with ListView, GridView, CustomScrollView/Slivers, NestedScrollView

• Plays nicely with infinite scroll (top refresh + bottom load)

• Offline-first (cache→revalidate / SWR) with optimistic UI hooks

• Safe-area aware (notch/status bar), overlays pinned app bars

• Theming: colors, height, typography, icons, elevation, shadow, spacing

• Accessibility: semantics, large hit targets, reduce-motion support, haptics

• Localization & RTL-ready text; customizable copy per state

• Real-device tested performance targeting 60fps

Use cases

• News/social feeds that need clear refresh feedback

• E-commerce lists refreshing inventory or prices

• Dashboards reloading KPIs, cards, and charts

• Media galleries and travel apps fetching new content

• Messaging/activity timelines re-syncing latest items

• Admin/CMS tables requiring quick requery without navigation

• Search/booking results after filter or location changes

• Offline apps exposing cached → fresh data on demand

Keywords
pull to refresh, status bar, release to refresh, completed checkmark, success banner, error state, loading spinner, Lottie indicator, progress mapping, refresh banner, top overlay, safe area, notch aware, debounce, throttle, timeout, single flight, programmatic refresh, last updated label, optimistic UI, cache then network, SWR pattern, infinite scroll, list view, grid view, slivers, nested scroll, haptic feedback, reduce motion, accessibility, localization, RTL support, theming, typography, elevation, shadow, mobile web, Flutter widget, FlutterFlow component, smooth animation, high performance, 60fps.