A gesture-driven reload control for scrollable lists and grids. Users drag down to reveal an animated drop/wave indicator that progresses through pull → armed → loading → success/error, refreshing data in place with haptics and smooth snap-back. Fully themeable and optimized for real devices.

Functionality

• Natural pull-down gesture with configurable threshold & resistance

• Indicator states: pull, armed, loading, success/error with snap-back

• Custom indicators: spinner, arrow→spinner morph, wave/drop/Lottie

• Haptic feedback on trigger; optional sound/vibration

• Programmatic API to refresh without a gesture

• Debounce, timeout, and minimum interval guards

• Works with ListView, GridView, CustomScrollView/Slivers, nested scrolls

• “Last updated” label and done checkmark (optional)

• Error handling: snackbar/toast + Retry callback

• Plays nicely with infinite scroll/pagination (top refresh only)

• Offline-first ready (cache → revalidate/SWR pattern)

• Safe-area aware; supports translucent status bars

• Theming: colors, sizes, indicator shape, corner radius, shadows

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

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

Use cases

• Social/news feeds that need quick manual reloads

• E-commerce category/product lists fetching new stock

• Dashboards refreshing KPIs, cards, and charts in place

• Messaging & activity timelines to re-sync data

• Booking/search results that requery with changed filters

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

• Offline apps surfacing cached → fresh content on demand

• Admin/CMS tables needing instant requery without navigation

Keywords
pull to refresh, swipe to refresh, refresh control, drag to refresh, over-scroll, elastic indicator, wave indicator, drop indicator, spinner, arrow morph, success checkmark, last updated label, debounce, throttle, timeout, retry action, error state, haptic feedback, programmatic refresh, infinite scroll, pagination, cache then network, SWR, offline first, slivers, list view, grid view, nested scroll, safe area, reduce motion, accessibility, theming, dark mode, mobile web, Flutter widget, FlutterFlow component, smooth animation, high performance.