A clean refresh interaction for scrollable lists and grids. Users drag down to reveal a progress indicator that animates through pull, loading, and success/error states. It’s haptic, fast, and fully themeable—perfect for feeds that fetch fresh data without leaving the page.

Functionality

• Natural pull-down gesture with threshold and resistance tuning

• Indicator states: pull → armed → loading → success/error

• Custom indicators: spinner, arrow→spinner morph, Lottie, or text

• Haptic feedback on trigger; optional sound/vibration

• Programmatic refresh API (call refresh without a gesture)

• Timeout, debounce, and min interval to prevent spam refreshes

• Works with ListView, GridView, CustomScrollView/Slivers

• Safe-area aware; top offset for notch/status bar

• Optional “Last updated” label & success checkmark

• Error handling: toast/snackbar + Retry action

• Cooperative with infinite scroll & pagination (top refresh only)

• Offline-first ready: shows cached data while fetching fresh (SWR)

• Theming: colors, sizes, corner radius, shadows, typography

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

• Callbacks: onPullStart, onCancel, onRefresh, onSuccess, onError

Use cases

• News and social feeds that need quick manual reloads

• E-commerce product lists or category pages fetching updates

• Dashboards refreshing cards, KPIs, and charts in place

• Messaging apps to re-sync conversations and unread counts

• Booking/search results where filters change server data

• Media libraries (albums/playlists) to fetch new items

• Offline apps that surface cached → fresh data on demand

• Admin tables and CMS collections needing instant requery

Keywords
pull to refresh, swipe to refresh, refresh control, drag to refresh, overscroll, refresh indicator, progress spinner, arrow indicator, success checkmark, error state, retry action, debounce, throttle, timeout, last updated label, safe area, haptic feedback, programmatic refresh, infinite scroll, pagination, offline first, cache then network, SWR pattern, list view, grid view, slivers, accessibility, reduce motion, theming, dark mode, Flutter widget, FlutterFlow component, mobile web, responsive UI, fast reload, smooth animation.